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Preface 


Read This First 


This preface summarizes the chapters, lists related documentation, and de¬ 
scribes the style and symbol conventions used in this book. 


How to Use This Manual 

This document contains the following chapters; 

Chapter 1 Introduction and Installation 

Provides an overview of the TMS320C30 software development tools, a 
walkthrough, and installation information. 

Chapter 2 C Compiler Operation 

Describes how to operate the C compiler and the CL30 program. Contains 
instructions for invoking CL30, which compiles, assembles, and links a C 
source file, and for invoking the individual compiler components. Discusses 
the interlist utility, filename specifications, compiler options, and using the 
linker and archiver with the compiler. 

Chapter 3 TMS320C30 C Language 

Discusses the differences between the C language supported by the 
TMS320C30 C compiler and standard Kernighan and Ritchie C language. 

Chapter 4 Runtime Environment 

Contains technical information on how the compiler uses the TMS320C30 
architecture: discusses memory and register conventions, stack organiza¬ 
tion, function-call conventions, system initialization, and TMS320C30 C 
compiler optimizations; provides information needed for interfacing assem¬ 
bly language to C programs. 

Chapter 5 Runtime-Support Functions 

Describes the header files that are included with the C compiler, as well as 
the macros, functions, and types that they declare, summarizes the 
runtime-support functions according to category (header), and provides an 
alphabetical reference of the runtime-support functions. 
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Appendix A Compiler Error Messages 

Provides the format of compiler error messages and lists all the fatal error 
messages. 

Appendix B Preprocessor Directives 

Describes the standard preprocessor directives that the compiler supports. 

Appendix C Increasing Code Generation Efficiency 

Presents guidelines for writing C programs that take advantage of the 
TMS320C30 C compiler optimizations. 


Related Documentation 


You should obtain a copy of The C Programming Language (first edition), 

by Brian W. Kernighan and Dennis M. Ritchie, published by Prentice-Hall, 

Englewood Cliffs, New Jersey, 1978, to use with this manual. 

You may find these two books useful as well: 

Programming in C Kochan, Steve G. Hayden Book Company. 

Advanced C: Techniques and Appiications Sobelman, Gerald E. and 

David E. Krekelberg. Que Corporation, 1985. 

The following books, which describe the TMS320C30 and related support 

tools, are available from Texas Instruments: 

□ The Third-Generation TMS320 User’s Guide (literature number 
SPRU031) discusses hardware aspects of the TMS320 family 
third-generation devices, including the TMS320C30. Topics in this 
user’s guide include pin functions, architecture, stack operation, and 
interfaces: the manual also includes the TMS320C30 assembly lan¬ 
guage instruction set. 

□ The TMS320C30 Assembiy Language Toois User’s Guide (litera¬ 
ture number SPRU035) describes the assembly language tools (as¬ 
sembler, linker, archiver, and code conversion utility), assembler 
directives, macros, commonobject file format, and symbolic debugging 
directives. 
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style and Symbol Conventions 

This document uses the following conventions: 

□ Program listings, program examples, interactive displays, filenames, 
and symbol names are shown in a special font. Examples use a bold 
version of the special font for emphasis. Here is a sample program seg¬ 
ment: 

extern float sine[]; /* This is the object */ 

float *sine_p = sine; /* Declare a C pointer 

to point to it */ 

f = sine_p[4]; /* Access sine like a 

normal array */ 

□ In syntax descriptions, the instruction, command, or directive is in a 
bold face font and parameters are in italics. Portions of a syntax that 
are in bold face should be entered as shown; portions of a syntax that 
are in italics describe the type of information that should be entered. 
Here is an example of a command syntax: 

InkSO filenames 

InkSO is a command. This command has one parameter, indicated by 
filenames. When you use InkSO, the first parameter must be a filename. 

□ Square brackets ([ and ]) identify an optional parameter. If you use an 
optional parameter, you specify the information within the brackets; you 
don’t enter the brackets themselves. Here’s an example of a command 
that has two optional parameters: 

cl30 [options] [filenames] 

cl30 is a command. This command has two optional parameters, indi¬ 
cated by options and filenames. When you use cISO, no parameters are 
necessary; however, if you do indicate parameters, they should appear 
in this order. 
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Chapter 1 


Introduction and Installation 


The TMS320C30 is a high-performance CMOS fioating-point microproces¬ 
sor, optimized for digitai signal processing appiications. The TMS320C30 
is a member of the third generation of TMS320 family digital signal proces¬ 
sors. , 

The TMS320C30 is fuliy supported by a compiete set of hardware and soft¬ 
ware development tools, including a C compiler, an assembler, linker, and 
archiver, a software simulator, and a full-speed emulator. Section1.1 
describes these tools. 

This reference guide describes the TMS320C30 C compiler. Its main pur¬ 
pose is to present the details and characteristics of this particular C compil¬ 
er: it assumes that you already know how to write C programs. We suggest 
that you obtain a copy of The C Programming Language, by Brian W. 
Kernighan and Dennis M. Ritchie (published by Prentice-Hall); use this ref¬ 
erence guide as a supplement to the Kernighan and Ritchie book. 

Texas Instruments provides a hotline to assist you with technical questions 
about the TMS320 family products and development tools. The phone num¬ 
ber is 713-274-2320. 

The TMS320C30 C compiler can be installed on the following systems: 

□ IBM-PC/PC-DOS and compatibles 

□ VAX/VMS 

Q VAX/ULTRIX 

□ Workstations with UNIX 

□ Macintosh with MPW 
Topics in this Chapter include: 


Section Page 

1.1 Software Development Tools Overview. 1-2 

1.3 Getting Started. 1-7 

1.4 Compiler Installation . 1-9 
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1.1 Software Development Tools Overview 

Figure 1-1 illustrates the TMS320C30 software development flow. The 
shaded portion of the figure highlights the typical software development 
path; the other portions are optional. 

Figure 1-1. TMS320C30 Software Development Flow 
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Software Development Tools Overview 


The following list describes the tools that are shown in Figure 1-1. 

□ The C compiler accepts C source code and produces TMS320C30 
assembly language source code. A CL30 program and an interlist util¬ 
ity are included in the compiler package.The CL30 program enables 
you to automatically compile, assemble, and link source modules. The 
interlist utility interweaves C source statements with assembly lan¬ 
guage output. Chapter 2 describes compiler, CL30, and interlist invoca¬ 
tion and operation. 

□ The assembler translates assembly language source files into ma¬ 
chine language object files. 

□ The archiver allows you to collect a group of files into a single archive 
file. (An archive file is also called a library.) Additionally, the archiver 
allows you to modify a library by deleting, replacing, extracting, or add¬ 
ing members. One of the most useful applications of the archiver is to 
build a library of object modules. 

One object library, rts.iib, is shipped with the C compiler. This library 
contains standard runtime-support functions, compiler utility functions, 
and math functions that can be called in C programs. You can also 
create your own object libraries. To use an object library, you must 
specify the library name as linker input; the linker will include the mem¬ 
bers in the library that define the functions you call in a C program. 

□ The linker combines object files into a single executable object module. 
As it creates the executable module, it performs relocation and resolves 
external references. The linker accepts relocatable COFF object files 
and object libraries as input. 

□ The main purpose of this development process is to produce a module 
that can be executed in a TMS320C30 target system. You can use one 
of several debugging tools to refine and correct your code before down¬ 
loading it to a TMS320C30 system. These debugging tools share a 
common screen-oriented interface that displays and maintains ma¬ 
chine status information and controls execution of the system that is be¬ 
ing developed. Note that only //nkecf object files can be executed. 

■ The simulator is a software program that simulates TMS320C30 
functions. The simulator can execute linked COFF object modules. 

■ The XDS emulator is a PC-resident, realtime, in-circuit emulator 
with the same screen-oriented interface as the software simulator. 

□ An object format converter is also available; it converts a COFF object 
file into an Intel word, extended Tektronix hex, or Tl-tagged object for¬ 
mat file that can be downloaded to an EPROM programmer. 


1-3 



Software Development Tools Overview 


A software platform is also available for augmenting your TMS320C30 C 
compiler: 

□ SPOX 

SPOX is a high-level software interface designed specifically for digital 
signal processing and control applications. It is a system of software 
components that you can combine according to your needs. SPOX pro¬ 
vides the common operating system functions of memory manage¬ 
ment, I/O, and multi-tasking. SPOX differs from traditionai operating 
systems by supplying an optimized math and DSP library as well as 
real-time stream I/O. SPOX is availabie from Spectron Microsystems, 
Incorporated. 
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1.2 TMS320C30 C Compiler Overview 

The TMS320C30 C compiler is a full-feature optimizing compiler that trans¬ 
lates standard Kernighan and Ritchie C programs into TMS320C30 
assembly language source. The following list describes key characteristics 
of the compiler: 

□ Standard Kernighan and Ritchie C with Extensions 

The compiler compiles standard C programs as defined by Kernighan 
and Ritchie’s The C Programming Language (first edition). The com¬ 
piler supports these standard extensions: enumeration types, structure 
assignments, passing structures to functions, and returning structures 
from functions. A future release of the compiler will support the full ANSI 
standard. For more information, refer to Chapter 3. 

□ 32-Bit Data Sizes 

All data sizes (char, short, int, long, float, and double) are 32 bits. This 
allows all types of data to take full advantage of the TMS320C30’s 
32-bit integer and floating-point arithmetic capabilities. For more infor¬ 
mation, refer to Section 3.2 on page 3-4. 

□ Big and Smali Memory Models 

The compiler supports two memory models.The small memory model 
enables the compiler to efficiently access memory by restricting the 
global data space to a single 64K-word data page. The big memory 
model allows unlimited space. For more information, refer to Section 
4.1 on page 4-2. 

□ Optimization 

The compiler uses several advanced techniques for generating 
efficient, compact code from C source. For more information the C 
compiler’s optimization techniques, refer to Section 4.9 on page 4-28 
and Appendix C. 

□ Assembly Source Output 

The compiler generates assembly language source that is easily in¬ 
spected, enabling you to see the code generated from the C source 
files. 

□ COFF Object Files 

The COFF format allows you to define you system’s memory map at link 
time. This maximizes performance by enabling you to link C code and 
data objects into specific memory areas. COFF also provides rich sup¬ 
port for source-level debugging. 
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□ ROM-able Code 

For stand-alone embedded applications, the compiler enables you to 
link all code and initialization data into ROM. 

□ ANSI Standard Runtime Support 

The compiler package comes with a complete runtime library. Ail library 
functions conform to the ANSI C library standard. The library includes 
functions for string manipulation, dynamic memory allocation, data con¬ 
version, timekeeping, trigonometry, exponential, and hyperbolic 
functions. Functions for I/O and signal handling are not included be¬ 
cause these are target-system specific. For more information, refer to 
Chapter 5. 

Q Flexible Assembly Language Interface 

The compiler has straight-forward caiiing conventions, allowing you to 
easily write assembly and C functions that call each other. For more in¬ 
formation, refer to Chapter 4. 

□ CL30 Compiler Shell Program 

The compiler package includes a CL30 shell program which enables 
you to compile, assemble, and link programs in a single step. For more 
information, refer to Chapter 2. 

□ Source Interlist Utility 

The compiler package includes a utility that interlists your original C 
source statements into the assembly language output of the compiler. 
This utility provides you with an easy method for inspecting the 
assembly code generated for each C statement. For more information, 
refer to Section 2.7 on page 2-14. 
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1.3 


Getting Started 


The TMS320C30 C compiler has three parts: a preprocessor, a parser, and 
a code generator. The compiler produces a single assembly language 
source file that must be assembled and linked. The simplest way to compile, 
assemble, and link a C program is to use the CL30 program which is 
included with the compiler. This section provides a quick walkthrough so 
that you can get started without reading the entire reference guide. 


1) Create a sample file called function.c that contains the following 
code: 


/* function.c */ 

/* (Sample file for walkthrough) */ 

/***:*r^*****yc****************^********:^/ 

#include "stdlib.h" 

int abs(i) 
int i; 

{ 

register int temp = i; 
if (temp < 0) temp = -temp; 
return (temp); 

} 


2 ) 


Invoke CL30 to run the compiler and assembler. 


cl30 function 


CL30 prints the following information as it compiles the program: 


[function] 



C Pre-Processor, 

Version 2.00 


(c) Copyright 1987, 1989, 

Texas Instruments 

Inc. 

TMS320C30 C Compiler, 

Version 2.00 


(c) Copyright 1987, 1989, 
"function.c" ==> abs 

Texas Instruments 

Inc. 

TMS320C30 C Codegen, 

Version 2.00 


(c) Copyright 1987, 1989, 
"function.c" ==> abs 

Texas Instruments 

Inc. 

TMS320C30 COFF Assembler, 

Version 2.00 


(c) Copyright 1987, 1989, 
PASS 1 

PASS 2 

No Errors, No Warnings 

Texas Instruments 

Inc. 


CL30 runs the three compiler passes and the assembler as follows: 


cpp30 
oc30 —^ 

cg30 

asm30 -> 


C Preprocessor 
C Parser 
Code Generator 
Assembler 
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By default, CL30 deletes the assembly language output file from the 
compiler after it’s assembled. If you wish to inspect the assembly lan¬ 
guage output of the compiler, use the -k option on CL30. 

3) Also by default, CL30 creates a COFF object file as output; however, 
if you use the -z option, the output will be an executable object module. 
The following examples walk you through the two ways of achieving an 
executable object module: 

a) The example above creates an object file called function, obj. To 
create an executable object module, link the object file with the 
runtime-support iibrary rts.iib: 

lnk30 -c function -o function, out -1 rts.iib |Pi^ 

This examples uses the -c linker option because the code came 
from a C program. The -i option tells the linker that the input file 
rts. lib is an object library. The -o option names the output mod¬ 
ule, function.out; if you don’t use the -o option, the linker names 
the output module a. out. 

b) In this example, CL30 runs the linker directly by using the -z option, 
followed by the linker options. 

cl30 function -z -o function.out -1 rts.iib 

This example runs the three compiler passes, the assembler, and 
the linker as foilows: 


cpp30 ^ 
cc30 
cg30 
asm30 
Ink30 -> 


C Preprocessor 
C Parser 
Code Generator 
Assembler 
Linker 


4) The TMS320C30 includes an interlist utility. This program inter¬ 
weaves the C source statements as comments in the assembly lan¬ 
guage compiler output, allowing you to inspect the assembly language 
generated for each line of C. To run the interlist utility, invoke CL30 with 
the -s option. For example: 


cl30 function -z -s -o function.out 


-1 rts.iib 


The output of the interlist utility is written to the assembly language file 
created by the compiler. (The CL30 -s option implies -k; that is, when 
you use the interlist utility, the assembly file is automatically retained.) 


For more information about invoking the C compiler, the interlist utility and 
the CL30 program, refer to Chapter 2. 
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1.4 Compiler Installation 

This section contains step-by-step instructions for installing the 
TMS320C30 C compiler. Refer to the following sections for installation infor¬ 
mation: 


Section installing on... Page 

1.4.1 IBM PCs. 1-9 

1.4.2 DEC VAX/VMS . 1-10 

1.4.3 VAX/ULTRIX. 1-10 

1.4.3 Workstations with Unix. 1-10 

1.4.4 Macintosh with MPW . 1-11 


1.4.1 Installing the C Compiler on IBM-PCs with PC-DOS 

The C compiler package is shipped on double-sided, dual-density diskettes. 
The compiler executes in batch mode and requires 512K bytes of RAM. 

These instructions are for both hard-disk systems and dual floppy drive 
systems (however, we recommend that you use the compiler on a hard-disk 
system). On a dual-drive system, the PC-DOS system diskette should be 
in drive B. The instructions use these symbols for drive names: 

A: Floppy disk drive for hard disk systems; source drive for dual-drive 
systems. 

B: Destination or system disk for dual-drive systems. 

C: Winchester (hard disk) for hard-disk systems. 

Follow these instructions to install the software: 


1) Make backups of the product diskettes. 

2) Create a directory to contain the C compiler. If you’re using a dual-drive 
system, put the disk that will contain the tools into drive B. 

□ On ftard-d/s/f systems, enter: 

MD C:\C30TOOLS |g| 

□ On dual-drive systems, enter: 

MD B:\C30TOOLS Q 

3) Copy the C compiler package onto the hard disk or the system disk. Put 
the product diskette in drive A; if you’re using a dual-drive system, put 
the disk that will contain the tools into drive B. 

□ On/tard-d/s/f systems, enter: 

COPY A:\*.* C:\C30TOOLS\*.* 

□ On dual-drive systems, enter: 

COPY A:\*.* B:\C30TOOLS\*.* |g| 

4) Repeat steps 1 through 3 for each product diskette. 
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1.4.2 Installing the C Compiler on VAX/VMS 

The TMS320C30 C compilertape was created with the VMS BACKUP utility 
at 1600 BPI. These tools were developed on version 4.5 of VMS. If you are 
using an earlier version of VMS, you may need to relink the object files; refer 
to the release notes for relinking instructions. 

Follow these instructions to install the compiler: 

1) Mount the tape on your tape drive. 

2) Execute the following VMS commands. Note that you must create a 
destination directory to contain the package; in this example, 
DEST; directory represents that directory. Replace tape with the 
name of the tape drive you are using. 


$ 

allocate 

TAPE: 


$ 

mount/f or/d.en=l 600 

TAPE: 


$ 

backup 

TAPE:c30.bck/select=[master.c30c.. 

] DEST: [directory...] 

$ 

dismount 

TAPE: 


$ 

dealloc 

TAPE: 



3) The product tape contains a file called setup. com. This file sets up VMS 
symbols that allow you to execute the tools in the same manner as other 
VMS commands. Enter the following command to execute the file: 

$ @setup DEST:directory jQ] 

This sets up symbols that you can use to call the various tools. As the file 
is executed, it will display the defined symbols on the screen. 

1.4.3 installing the C Compiler on Workstations with UNIX 

The TMS320C30 C compiler product tape was made using the tar utility. 
Follow these instructions to install the compiler: 

1) Mount the tape on your tape drive. 

2) Make sure that the directory you store the tools in is the current 
directory. 

3) Enter the tar command for your system; for example, 

tar X 

This copies the entire tape into the directory. The tar command varies 
from system to system; consult your system documentation for proper 
use of the tar command. 
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1.4.4 Installing the C Compiler on Macintosh with MPW 

The TMS320C30 compiler package runs only under the Macintosh 
Programmer’s Workshop (MPW). MPW is a complete software develop¬ 
ment environment for Macintosh Computers that can be purchased through 
for Apple. These tools cannot be run on a Macintosh without MPW. 

The C compiler is shipped on a double-sided, 800k, 31 /2” diskette. The disk 
contains three folders: 


[ 


_r ^ 

r ^ 

Tools 


Includes 


Libraries 


Use the Finderto display the disk contents and copy the files into your MPW 

environment: 

1) The Too/sdirectorycontainsallthe programs and the batchfilesfor run¬ 
ning the compiler. Copy this directory in with your other MPW tools 
(MPW tools are usually in the folder {MPW}Tools.) 

2) The Includes directory contains the header files (. h files) for the run- 
time-support functions. Many of these files have names that conflict with 
commonly-used MPW header files, so you should keep these header 
files separate from the MPW files. Copy the contents of the Includes di¬ 
rectory into a new folder, and use the C_DIR environment variable. For 
information describing how to create a path to this folder, refer to Sec¬ 
tion 2.8.1.1 on page 2-18. 

3) The L/brar/esfolder contains the compiler’s runtime-support object and 
source libraries. You can copy these files into the folderthat you created 
for the header files, or you can copy them into a new folder. If you copy 
them into a new folder, use the C_DIR environment variable to create 
a path to this folder as well. 
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Chapter 2 


C Compiler Operation 


The TMS320C30 C compiler is made up of three programs: the 
preprocessor, the parser, and the code generator. After compiling a pro¬ 
gram, you must assemble and link it with the TMS320C30 assembler and 
linker. The CL30 program, inciuded with the compiler, enables you to auto¬ 
matically compile, assemble, and link one or more source modules. 

The compiler package also includes a utility that interlists your original C 
source statements into the assembly language output of the compiler, 
enabling you to inspect the assembly code generated for each C statement. 
The interlist utility is explained in Section 2.7. 

If you choose to run the three compiler steps individually. Section 2.8 de¬ 
scribes how to run the preprocessor, parser, and code generator 
individually. 

Topics in this chapter include: 


Section Page 

2.1 C Compiler Overview.2-2 

2.2 Invoking the C Compiier . 2-3 

2.3 Filename Specifications. 2-4 

2.4 Options . 2-6 

2.5 Running the Linker with CL30. 2-11 

2.6 Using the C_OPTION Environment Variable. 2-13 

2.7 Interlist Utility Operation . 2-14 

2.8 Operating the Preprocessor, the Parser, and the Code 

Generator Individually . 2-16 

2.9 Linking a C Program . 2-24 

2.10 Using the Archiver with C . 2-28 
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C Compiler Overview 


2.1 C Compiler Overview 

The TMS320C30 C compiler is made up the preprocessor, the parser, and 
the code generator. 

After you have compiled a program, you must assemble and link it with the 
TMS320C30 assembler and linker. A program called CL30 is provided with 
the compiler which automatically runs one or more source modules through: 

□ the three compiler passes, 

□ the assembler, and 

□ if the -z option is used, the linker. 

Figure 2-1 illustrates CL30 with and without the -z option.You can invoke 
CL30 with compiler, assembler, and linker options, and CL30 will automati¬ 
cally vector the options to the appropriate program. You may also set CL30 
default options by using the C_OPTION environment variable; these de¬ 
faults options are used every time you run CL30. 

Figure 2-1. CL30 Overview 
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2.2 Invoking the C Compiler 


To run the compiler, enter 

cl30 [-options] [filenames] [-z [iinkjoptions]] 


cl30 is the command that invokes the compiier and assembier. 

options affect the way the compiler processes input fiies. 

filenames are one or more C source files, assembly source files, or ob¬ 
ject files. 

-z option that runs the iinker. 

link_options affect the way the linker processes input files. 

Options and filenames can be specified in any order on the command iine, 
but if you use the-z option, it must follow all filenames and compiler options. 
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2.3 Filename Specifications 


The input files specified on the command line can be C source files, assem¬ 
bly source files, or object files. CL30 uses filename extensions to determine 
the file type. 


Extension 

File Type 

File Description 

.c 

C source 

compiled, assembled, and (linked) 

.asm 

assembly 

source 

assembled and (linked) 

-s* (extension 
begins with s) 

assembly 

source 

assembled and (linked) 

.o* (extension 
begins with o) 

object file 

linked 

none (.c assumed) 

C source 

compiled, assembled, and (linked) 


Extensions and filenames are not case sensitive. Files without extensions 
are assumed to be C source files and a .c extension is appended. You can 
override these file type interpretations by using the -f option as follows; 

-fa file for an assembly file 
-fc file for a C source file 
-fo file for an object file 

You can use wildcard specifications to compile multiple files. Wildcard 
specifications vary by system; use the appropriate form. 

You can compile and assemble source files with a single command. Here 
are some examples. 

1) To compile all the files in a directory, enter: 

cl30 * . c |U-i|| 


2) To compile a source file named hiiev. c and two assembly files called 
lowiev. asm and iowiev2.asm, enter: 


cl30 hiiev lowlevl.asm lowlev2.asm 
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sssssssssssssss: 


As CL30 encounters each source file, it prints the filename in square 
brackets [for c files] or angle brackets <for asm files>. Progress information 
is output from each of the compiler passes unless the-q option is specified. 
If you use the -q option, only the source filenames print. If you use the -qq 
option, no progress information prints except error messages. Forexampie, 
the output from compiling a single module might be: 


$ cl30 symtah |pili[| 

[symtab] 

C Pre-Processor 

(c) Copyright 1987, 1989, Texas 
TMS320C30 C Compiler 
(c) Copyright 1987, 1989, Texas 
"symtab.c":==> main 
"symtab.c":==> lookup 
TMS320C30 C Codegen 
(c) Copyright 1987, 1989, Texas 
"symtab.c":==> main 
"symtab.c":==> lookup 
TMS320C30 COFF Assembler 
(c) Copyright 1987, 1989, Texas 
PASS 1 
PASS 2 


Version 2.00 

Instruments Incorporated 
Version 2.00 

Instruments Incorporated 


Version 2.00 

Instruments Incorporated 


Version 2.00 

Instruments Incorporated 


No Errors, No Warnings 


Using the quiet option (-q) to compiie muitiple fiies, you might get: 


$ cl30 -q symtab file seek.asm [^| 

[symtab] 

[file] 

<seek.asm> 
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2.4 Options 

Command line options control the operation of both CL30 and the programs 
it calls. 

2.4.1 Option Conventions 

Options are either single letters or two-letter pairs, are not case sensitive, 
and are preceded by a hyphen. Single-letter options without parameters can 
be combined: for example, -sgq is equivalent to -s -g -q. Two-letter pair 
options that have the same first letter can be combined: for example, -mrb 
is equivalent to -mr and -mb. Options that have parameters, such as -d, 
must be specified separately. 

Table 2-1 summarizes the following options: general, preprocessor, as¬ 
sembler, runtime model, filename, linker, and environment variable options. 
Section 2.4.2 provides an in-depth description of each of these options. 

Table 2-1. Options Summary Table 


General Options 

Usage: cl30 [-options] filenames... [-z link_options... ] 


-c 

no linking (negates -z) 

-q 

quiet 

-6name 

predefine name 

-qq 

super quiet 

-g 

symbolic debugging 

-s 

C source interlist 

-\<dir> 

#include search path 

-uname 

undefine name 

-k 

keep .asm file 

-z 

link, options follow 

-n 

compile only 




Preprocessor Options -p<options.. 

> 

-pc 1 

preprocess only 1 

1 -PP 

1 no #line directive 

Assembler Options -a<options... > 

-al 

assembly listing file 

-ax 

cross-reference file 

-as 

keep labels as symbols 

-ap 

preprocess first 


Runtime Model Options 


-ma 

assumes aliased variables 

-mb 

enables the big memory model 

-mm 

enables the short multiply 

-mn 

normal optimization, even with debug 
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Table 2-1. Options Summary Table (Continued) 


Runtime Model Options (continued) 


-mr 

lists register use information 

-mv 

volatile variables 

-mx 

avoids TMX silicon bugs 


-f options (File Specifiers) 


-iafile 

assembly language file 
(default for .asm or .s*) 

-fcff/e 

C source file 
(default for .c or no ext) 

-f 0 file 

object file (default for . 0 *) 


Linker Options (all options following -z go to the linker) 


-a 

absolute output 

-ar 

relocatable output 

-c 

ROM initialization 

-cr 

RAM initialization 

-esy/77 

entry point 

-ival 

fill value 

-h 

global symbols static 

-i dir 

library search path 

-\lib 

library name 

-m file 

map filename 

-ofile 

output filename 

-r 

relocatable output 

-s 

strip symbol table 

-usym 

undefine sym 


Environment Variables 


setenv C_OPTION ’’options” 

to set default options 

setenv C_DIR ”dlrs” 

to set cpp and linker search paths 


2.4.2 Option Descriptions 

This section contains descriptions of general, compiler, preprocessor, as¬ 
sembler, runtime model, and linker options. 

□ General Options 

-c suppresses the iinking option; it causes CL30 to not run the 
linker even if-zis specified.This option is especially useful when 
you have -z specified in the C_OPTION environment variable 
and you don’t want to link. For more information, refer to Section 
2.6 on page 2-13. 


2-7 









































Options 


2-8 


-g causes the compiler to generate symbolic directives for use with 

a high-level language debugger. 

-iof/r adds dir to the list of directories to be searched for #include files. 
You can use this option multiple times to define several 
directories; be sure to separate -/ options with spaces. Note that 
if you don’t specify a directory name, the preprocessor ignores 
the -i option. 

-k keeps the .asm file. Normally, CL30 deletes the output assembly 
language file after assembly is finished, but using -k allows you 
to retain the assembly source output from the compiler. 

-n causes CL30 to compile only. If you use -n, the specified source 

files are compiled but not assembled or linked. This option over¬ 
rides -z and -c. The output of -n is assembly source output from 
the compiler. 

-q suppresses banners and progress information from all the tools. 

Only source filenames and error messages are output. 

-qq suppresses all output except error messages. 

-s invokes the interlist utility, which interweaves C source state¬ 
ments into the assembly language output of the compiler, allow¬ 
ing you to inspect the code generated for each C statement. This 
option implies that the -k option is specified. For more informa¬ 
tion about the interlist utility, refer to Section 2.7 on page 2-14. 

-z enables the linking option; it causes CL30 to run the linker on 
specified object files, -z must follow all source files and compiler 
options on the command line. All arguments that follow-z on the 
command line are passed to and interpreted by the linker. 

-f -f options override default interpretations for source file exten¬ 
sions. If your naming conventions do not conform to those of 
CL30, you can use -f options to specify exactly which files are C 
source files, assembly files, or object files. You can insert an op¬ 
tional space between the -f option and the filename. 

-iafile This file is an assembly source file. 

-\cfile This file is C source file. 

-Mile This file is an object file. 

If you have a C source file called cf iie. s and an assembly file 
called assy, use -f to force the correct interpretation: 

cl30 -fc cfile.s -fa assy 

Note that -f cannot be applied to a wildcard file specification. 

C Compiler Operation 
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□ Compiler Options 

-dna/77e[=clef] pre-defines nameforthe preprocessor. This is equiva¬ 
lent to inserting #define name defat the top of each C 
source file. If the optional [def] if omitted, 
-dname[=def] sets name equal to 1. 

-uname undefines the predefined constant name. 

□ Preprocessor Options 

-pc causes the compilerto preprocess only, -pc runs the preproces¬ 
sor on the specified source files and retains the comments. The 
remaining compiler passes, the assembler, and the linker are not 
run. 

-pp suppresses line and file information, -pp causes the preproces¬ 
sor to suppress its normal location directives of the form: 

#123 file.c. 

-pp is sometimes useful when compiling machine-generated 
code. 

□ Assembler Options 

-al invokes the assembler with the-I (lowercase “L”) option to pro¬ 
duce an assembly listing file. 

-ap enables preprocessing, -ap runs the C preprocessor on the 
assembly source before assembling them. 

-as retains labels. Label definitions are written to the GOFF symbol 
table for use with symbolic debugging. 

-ax invokes the assembler with the -x option to produce a symbolic 
cross-reference in the listing file. 

For more information about assembler options, see Section 4.2, page 

4-3 in the TMS320C30 Assembly Language Tools User’s Guide. 

□ Runtime Model Options 

-ma assumes variables are aliased. The compiler assumes that 
pointers may alias (point to) named variables and therefore 
aborts register optimizations whenever an assignment is made 
through a pointer. 

-mb selects the big memory model, -mb allows unlimited space for 
global data, static data, and constants. In the small memory 
model, which is the default, this space is limited to 64k words. For 
more information, refer to Section 4.1 on page 4-2. 
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-mm enables the short multiply, -mm generates MPYI instructions for 
integer muitipies rather than runtime-support calls. If your appli¬ 
cation does not need 32x32-bit integer multiplication, use -mm 
to enable the MPYI instruction because it is significantly faster 
(but it performs only 24x24-bit multiplication). For more informa¬ 
tion, refer to Section 4.8 on page 4-26. 

-mn normal optimazation, even with debug. When you generate sym¬ 
bolic debugging information with the -g switch, the code genera¬ 
tor disables certain optimizations that inhibit debugging. You can 
use -mn to re-enable these optimizations and generate exactly 
the same code as without -g. 

-mr lists register use information. After the code generator compiles 
each C statement, -mr lists register contents tables as com¬ 
ments in the assembly file, -mr is useful for inspecting code that 
is difficult to follow due to register tracking optimizations. 

-mv assumes variables are volatile. Disables register tracking optimi¬ 
zations. Variables are always read from memory each time they 
are accessed. 

-mx avoids early silicon bugs, -mx enables the code generator to 
work around some of the known hardware bugs in early 
TMX320C30 devices. 

□ Linker Options 

All command line input following -z is passed to the linker. Table 2-1, 
on page 2-6, summarizes the linker options. For more information 
about linker options, see Section 9.3, page 9-4, in the TMS320C30 
Assembly Language Tools User’s Guide. 
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2.5 Running the Linker with CL30 

CL30, by default, does not run the linker; however, you can enable the linker 
by using the -z option. 

Figure 2-2. CL30 Overview with the Linker 



2.5.1 -z CL30 option 

When using -z to enable linking, remember: 

□ -c suppresses -z, so do not use -c if you want linking enabled, 

□ -z must follow all source files and compiler options on the command 
line, and 

□ -z divides the command line into compiler options (before -z) and linker 
options (following -z) 

All arguments that follow -z on the command line are passed to the linker. 
These arguments can be linker command files, additional object files, linker 
options, or libraries. 
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The order in which the linker processes arguments can be important, 
especially for command files and libraries. When you use CL30 to run the 
linker, it passes arguments to the linker in the following order. 

1) Object file names from the command line, 

2) Arguments following -z on the command line, and 

3) Arguments following -z from the C_OPTION environment variable. 
For example, to compile and link all the .c files in a directory enter: 

cl30 -sq -mm *.c -z c.cmd -o prog.out -1 rts.lib 

First, c/30 compiles all the files with *.c extensions using the -SQand -mm 
options. Second, because -z is specified, the linker runs the resulting object 
files using the the linker command file c.cmd, the -o option to name the out¬ 
put file, and the -/option to include the runtime-support library. 

For more information about linker operation, refer to Section 2.9 on page 
2-24 in this manual and Chapter 9, Linker Description, in the TMS320C30 
Assembly Language Tools User’s Guide. For more information about linker 
options, refer to Section 9.3 in the TMS320C30 Assembly Language Tools 
User’s Guide. 

2.5.2 -c CL30 Option 

Passing the -c option to CL30 overrides -z and disables linking. This option 
is helpful when you have specified -z in the C_OPTION environment vari¬ 
able and want to selectively disable linking with -c on the command line. 

2.5.3 -c and -or Linker Options 

The -c linker option has a different function than, and is independent of, 
the -c CL30 option. By default, CL30 automatically uses the -c option that 
tells the linker to use C source linking conventions (ROM model of initializa¬ 
tion). If you want to use -cr (RAM model of initialization) rather than -c, you 
can pass -cr as a linker option. 
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2.6 Using the C_OPTION Environment Variabie 

You can set up default options for CL30 using the C_OPTION environment 
variable. After CL30 reads the entire command line, it reads the C_OPTION 
environment variable and processes it. 

Options in the environment variable are specified in the same way and have 
the same meaning as they do on the command line. 

For example, if you want to always run quietly, enable symbolic debugging, 
and link, then set up the C_OPTION environment variable as follows: 


Host 

Enter: 

DOS 

set C_OPTION=-qg -z 

UNIX 

setenv C_OPTION ”-qg -z” 

VAX/VMS 

assign ”-qg -z” C_OPTION 

MPW 

set C_OPTION ”-qg -z”; export C_OPTION 


Using the -z option in the environment variable enables linking. In the exam¬ 
ples above, each time you run CL30, it will run the linker. Any options follow¬ 
ing -z on the command line are passed to the linker; likewise, any options 
following -z on the options line are passed to the linker. This enables you 
to use the environment variable to specify default compiler and linker op¬ 
tions and then specify additional compiler and linker options on the CL30 
command line. If you have set -z in the environment variabie and want to 
compile (or assemble) only, use the -c option of CL30. These additional 
examples assume C_OPTION is set as shown above: 


Cl30 ^.C 
cl30 -c 

cl30 *.c -z c.cmd 
cl30 -c *.c -z c.cmd 


compiles and links 
only compiles 

compiles and links using a command file 
only compiles (-c overrides -z) 
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2.7 Interlist Utility Operation 

The compiler package includes a utility that interlists your original C source 
statements into the assembly language output of the compiler. The interlist 
utility enables you to inspect the assembly code generated for each C state¬ 
ment. 

2.7.1 Invoking the Interlist Utility Using the -s CL30 Option 

The easiest way to invoke the interlist utility is to use the -s CL30 option. 
To compile and run the interlist utility on a program called function. c, en¬ 
ter: 

cl30 “S function 

The interlist runs a separate pass between the code generator and the as¬ 
sembler. It reads both the assembly and C source files, merges them, and 
writes the C statements into the assembly file as comments (beginning with 
»»). The output assembly file is assembled normally. The -s option auto¬ 
matically prevents CL30 from deleting the interlisted assembly language 
file. 

Figure 2-3 shows a typical interlisted assembly file. 

Figure 2-3. An Example of an Interlisted Assembly File 
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2.7.2 Invoking the Interlist Utility Outside CL30 

Even if you are not using CL30, you can stiil use the interiist utiiity. After you 
have compiied a program, you can run the interiist utility as a standalone 
program from the command line. To run the interiist utility from the command 
line, the syntax is: 

cHst asmfile [outfile] [-options] 


clist is the command that invokes the interiist utility. 

asmfile is the assembly language output from the compiler. 

outfile names the interlisted output file. If you omit this, the file has 
the same name as the assembly file with the the extension .cl. 

options control the operation of the utility as follows: 

-b removes blanks and useless lines (lines containing 
comments or lines containing only { or }). 

-r removes symbolic debugging directives. 

-q removes banner and status information. 

The interiist utility uses the .line directives produced by the code generator 
to associate assembly code with C source. For this reason, you must 
specify symbolic debugging when compiling the program if you want to in¬ 
teriist it. If you do not want the debugging directives in the output, use the 
-r option to remove them from the interlisted file. 

The following example shows howto compile and interiist function.c. 


Function 

To invoke, enter: 

Comments 

compile 

cl30-gk function 

compile, use debug, keep assembly 

interiist 

clist -r function 

interiist, remove debug 


The output from this example is function. ci. 
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2.8 Operating the Preprocessor, the Parser, and the 
Code Generator Individually 

The TMS320C30 C compiler is made up of three distinct programs: the pre¬ 
processor, the parser, and the code generator. This section provides infor¬ 
mation about how to run the individual programs. 

□ The input for the preprocessor is a C source file (as described in 
kernighan and Ritchie). The preprocessor produces a modified version 
of the source file. Section 2.8.1 describes how to run the preprocessor. 

□ The input for the parser is the modified source file produced by the pre¬ 
processor. The parser produces an intermediate file. Section 2.8.2 
describes how to run the parser. 

□ The input for the code generator is the intermediate file produced by 
the parser. The code generator produces an assembly language source 
file. Section 2.8.3 describes how to run the code generator. 

Figure 2-4. Compiling a C Program 



Refer to the following sections for more information: 


Section Page 

2.8.1 Preprocessing C Code . 2-17 

2.8.2 Parsing C Code. 2-21 

2.8.3 Generating Assembly Language Code. 2-22 
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2.8.1 Preprocessing C Code 

The first step in compiling a TMS320C30 C program is to invoke the C pre¬ 
processor. The preprocessor handles macro definitions and substitutions, 
#include files, line number directives, and conditional compilation. As 
Figure 2-4 shows, the preprocessor uses a C source file as input, and pro¬ 
duces a modified source file that can be used as input for the C parser. 


To invoke the preprocessor as a standalone program, enter: 


cpp30 [input file [output file]] [options] 


cpp30 is the command that invokes the preprocessor. 

input file names a C source file that the preprocessor uses as input. If 
you don’t supply an extension, the preprocessor assumes 
that the extension is .c. If you don’t specify an input file, the 
preprocessor will prompt you for one. 

output file names the modified source file that the preprocessor creates. 

If you don’t supply afilenameforthe output file, the preproces¬ 
sor uses the input filename with an extension of .cpp. 

options affect the way the preprocessor processes your input file.Op- 

tions are not case sensitive. Valid options include: 

-c copies comments to the output file. If you don’t use 
this option, the preprocessor strips comments. 

-dname{=def] See Compiler Options, page 2-9. 

-idir adds dir to the list of directories to be searched for 
#include files. See Compiler Options, page 2-9. 

-p suppresses line number and file information. 

-q suppresses the banner and status information. 

This preprocessor is described in Kernighan and Ritchie; additional infor¬ 
mation can be found in that book. The preprocessor supports the same pre¬ 
processor directives that are summarized in Appendix B of that book. All 
preprocessor directives begin with the character #, which must appear in 
column 1 of the source statement. Any number of blanks and tabs may 
appear between the # sign and the directive name. 
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The C preprocessor maintains and recognizes five predefined macro 
names: 

_ LINE _represents the current line number (maintained as a decimal 

integer). 

_ FILE _represents the current filename (maintained as a C string). 

_ DATE _represents the date that the module was compiled (main¬ 
tained as a C string). 

_ TIME _represents the time when this module was compiled (main¬ 
tained as a C string). 

_320C30 identifies the compiler as the TMS320C30 C compiler; this 
symbol is defined as the constant 1. 

You can use these names in the same manner as any other defined name. 
For example, 

printf {"%s %s",_TIME_,_^DATE_); 

would translate into a line such as: 

printf(%s %s", "May 1 1989", "13:58:17"); 

The preprocessor produces self-explanatory error messages. The line 
number and the filename where the error occurred are printed along with 
a diagnostic message. 

2.8.1.1 Specifying Aiternate Directories for inciude Fifes 

The #include preprocessor directive tells the preprocessor to read source 
statements from another file. The syntax for this directive is: 

#include "filename" or #include <filename> 

The filename names an include file that the preprocessor reads statements 
from; you can enclose the filename in double quotes or in angle brackets. 
The filename can be a complete pathname or a filename with no path infor¬ 
mation. 

□ If you provide path information for filename, the preprocessor uses that 
path and does not lookior the file in any other directories. 

□i If you do not provide path information and you enclose the filename in 
double quotes, the preprocessor searches for the file in this order: 

1) The directory that contains the current source file. (The current 
source file refers to the file that is being processed when the prepro¬ 
cessor encounters the #include directive.) 

2) Any directories named with the -i preprocessor option. 

3) Any directories set with the environment variable C_DIR. 
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□ If you do not provide path information and you enclose the filename in 
angle brackets, the preprocessor searches for the file in: 

1) Any directories named with the -i preprocessor option. 

2) Any directories set with the environment variable C_DIR. 

Note that if you enclose the filename in angle brackets, the preproces¬ 
sor does not search for the file in the current directory. 

You can augment the preprocessor’s directory search algorithm by using 
the -i preprocessor option or the environment variable C_DIR. 

2.8.1.2 -i Preprocessor Option 

The -i preprocessor option names an alternate directory that contains 
include files. The format of the -i option is: 

cpp30 -i pathname 

You can use up to 10 -i options per invocation; each -i option names one 
pathname. In C source, you can use the #include directive without specify¬ 
ing any path information for the file; instead, you can specify the path infor¬ 
mation with the -i option. For example, assume that a file called source.c 
is in the current directory; source. c contains the following directive state¬ 
ment: 

tinclude "alt.c" 

The table below lists the complete pathname for ait. c and shows how to 
invoke the preprocessor; select the row for your operating system. 



Pathname for alt.c 

Invocation Command 

DOS 

c:\C30\filesXalt.c 

cpp30 -ic:\C30\files source.c 

VMS 

[C30.files]alt.c 

cpp30 -i[C30.files] source.c 

UNIX 

/C30/files/alt.c 

cpp30 -i/C30/files source.c 

MPW 

:C30:files:alt.c 

cpp30 -i:C30 :files source.c 


Note that the include filename is enclosed in double quotes. The preproces¬ 
sor first searches for ait. c in the current directory, because source. c is 
in the current directory. Then, the preprocessor searches the directory 
named with the -i option. 

2.8.1.3 Environment Variable 

An environment variable is a system symbol that you define and assign a 
string to. The preprocessor uses an environment variable named C_DIR to 


2-19 



The Preprocessor, Parser, and Code Generator 


name alternate directories that contain include files. The commands for as¬ 
signing the environment variable are; 


DOS: 

set 

c_DiR= pathname;anotherpathname ... 

VMS: 

assign 

”pathname;another pathname... ” c dir 

UNIX: 

setenv 

c_DiR ”pathname;anotherpathname... ” 

MPW: 

set 

c_DiR ”pathname;another: pathname... 


export 

C_DIR 


The pathnames are directories that contain include files. You can separate 
pathnames with a semicolon or with blanks. In C source, you can use the 
#include directive without specifying any path information: instead, you can 
specify the path information with C_DIR. 

Forexample, assume thatafilecailed source. c contains these statements: 

#include <altl.c> 

#include <alt2.c> 

The table below lists the complete pathnames for these files and shows how 
to invoke the preprocessor: select the row for your operating system. 



Pathname for aiti.c 
and alt2.c 

Invocation Command 

DOS 

c:\C30\filesXaltl.c 
c:\sys\alt2.c 

set C_DIR=c:\sys c:\exec\files 
cpp30 -ic:\C30\files source.c 

VMS 

[C30.files]altl.c 
[sys]alt2.c 

assign C__DIR "[sys] [exec. files] " 
cpp30 -i[C30.files] source.c 

UNIX 

/C30/files/altl.c 
/ygs/alt2.c 

setenv C_DIR "/sys /exec/files 
cpp30 -i\C30\files source.c 

MPW 

;C30ifiles :altl .c 
:sys:alt2.c 

set C_DIR " ; sys -.files " 
export C_DIR 

cpp30 -i:C30 ifiles source.c 


Note that the inciude filenames are enclosed in angle brackets. The prepro¬ 
cessor first searches for these files in the directories named with C_DIR and 
finds ait 2 . c. Then, the preprocessor searches in the directories named 
with the -i option and finds aiti. c. 

The environment variable remains set untii you reboot the system or reset 
the variable by entering: 


DOS: 

set 

C_ 

_DIR= 

VMS: 

deassign 

C_ 

_DIR 

UNIX: 

setenv 

C_ 

_DIR 

MPW: 

unset 

C 

DIR 
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2.8.2 Parsing C Code 

The second step in compiling a TMS320C30 C program is to invoke the C 
parser. The parser reads the modified source file produced by the prepro¬ 
cessor, parses the file, checks the syntax, and produces an intermediate file 
that can be used as input for the code generator. (Note that the input file can 
also be a C source file that has not been preprocessed.) 

To invoke the parser as a standalone program, enter: 

co30 [Input file [output file]] [options] 


cc30 is the command that invokes the parser. 

input file names the preprocessed C source file that the parser uses as 
input. If you don’t supply an extension, the parser assumes 
that the extension is .cpp. If you don’t specify an input file, the 
parser will prompt you for one. 

output file names the intermediate file that the parser creates. If you 
don’t supply a filename for the output file, the parser uses the 
input filename with an exterision of .if. 

options affectthe way the parser processes the inputfile. Valid options 

include: 

-q suppresses the banner and status information. 

-z tells the parser to retain the input file (the 
intermediate file created by the preprocessor). If you 
don’t specify-z, the parser deletes the .cpp input file. 
(The parser never deletes files with the .c extension.) 

Most errors are fatal; that is, they prevent the parser from generating an in¬ 
termediate file and must be corrected before you can finish compiling a pro¬ 
gram. Some errors, however, merely produce warnings that hint of prob¬ 
lems but do not prevent the parser from producing an intermediate file. 

When the parser encounters function definitions, it prints a progress mes¬ 
sage that contains the name of the source file and the name of the function. 
Here is an example of a progress message: 

”filename.c”: => main 

This type of message shows how far the compiler has progressed in its ex¬ 
ecution and helps you to identify the locations of an error. You can use the 
-q option to suppress these messages. 

If the input file has an extension of. cpp, the parser deletes it upon comple¬ 
tion un/ess you use the -z option. If the inputfile has an extension otherthan 
. cpp, the parser does not delete it. 
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The intermediate file is a binary file; do not try to inspect or modify it in any 
way. 

2.8.3 Generating Assembly Language Code 

The third step in compiling a TMS320C30 C program is to invoke the C code 
generator. As Figure 2-4 on page 2-16 shows, the code generator con¬ 
verts the intermediate file produced by the parser into an assembly lan¬ 
guage source file. You can modify this output file or use it as input for the 
TMS320C30 assembler. The code generator produces re-entrant relocat¬ 
able code, which, after assembling and linking, can be stored in ROM. 


To invoke the code generator as standalone, enter: 


cg30 [input file [ouput file [tempfile]]] [options] 


cg30 is the command that invokes the code generator. 

input file names the intermediate file that the code generator uses as 
input. If you don’t supply an extension, the code generator as¬ 
sumes that the extension is .if. If you don’t specify an input file, 
the code generator will prompt you for one. 

output file names the assembly language source file that the code gen¬ 
erator creates. If you don’t supply a filename for the output file, 
the code generator uses the input filename with an extension 
of .asm. 

tempfile names a temporary file that the code generator creates and 
uses. The default filename for the temporary file is the input 
filename appended with an extension of .tmp. The code gen¬ 
erator deletes this file after using it. 

options affect the way the code generator processes the input file. 
Valid options include: 

-a assumes variables are aliased. For more informa¬ 
tion, refer to Section 2.4 on page 2-9 

-b tells the compiler to generate code for the big 
memory model. 

-m enables the short multiply. For more information, 
refer to Section 2.4 on page 2-9. 
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-n normal optimization, even with debug. When you 
generate symbolic debugging information with the -g 
switch, the code generator disables certain optimiza¬ 
tions that inhibit debugging. You can use -mn to re¬ 
enable these optimizations and generate exactly the 
same code as without -g. 

-o tells the code generator to place symbolic debugging 

directives in the output file. See Appendix B of the 
TMS320C30 Assembly Language Tools User’s 
Guide for more information about these directives. 

-q suppresses the banner and status information. 

-V assumes variables are volatile.Varlables are always 
read from memory each time they are accessed. For 
more information, refer to Section 2.4 on page 2-9 

-X avoids early silicon bugs, -x enables the code gener¬ 

ator to work around some of the known hardware 
bugs in early TMX320C30 devices. 

-z tells the code generator to retain the input file (the in¬ 
termediate file created by the parser). This option is 
useful for creating several output files with different 
options; for example, you might want to use the same 
intermediate file to create one file that contains sym¬ 
bolic debugging directives (-0 option) and one that 
doesn’t. Note that if you do not specify the -z option, 
the code generator deletes the input (intermediate) 
file. 
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2.9 Linking a C Program 

The TMS320C30 C compiler and assembly language tools support modular 
programming by allowing you to compile and assemble individual modules 
and then link them together. To link compiled and assembled code, enter: 

Ink30 -c filenames ~o name.out -I rts.Hb 
Ink30 ~cr filenames -o name.out -I rts.lib 


InkSO is the command that invokes the linker. 


-c/-cr are options that tell the linker to use special conventions 

that are defined by the C environment. Note that when you 
use CL30 to link, CL30 passes -c to the linker automatical¬ 
ly- 

filenames are object files created by compiling and assembling C pro¬ 

grams. 

-o name.out names the output file. If you don’t use the -o option, the 
linker creates an output file with the default name of 

a.out. 


rts.lib rts. lib is an archive library that contains C runtime-sup¬ 

port functions. (The -1 option tells the linker that a file is an 
object library.) The library is shipped with the C compiler. If 
you’re linking C code, you must use rts.lib. Whenever 
you specify a library as linker input, the linker includes and 
linksonly those library members that resolve undefined ref¬ 
erences. 


For example, you can link a C program consisting of modules progi, 
prog2, and prog3 (the output file is named prog. out): 

InkSO -c progi prog2 prog3 -1 rts.lib -o prog.out 

The linker uses a default allocation algorithm to allocate your program into 
memory. You can use the MEMORY and SECTIONS linker directives to 
customize the allocation process. 


2.9.1 Runtime Initialization and Runtime Support 

All C programs must be linked with the boot. ob j object module;this module 
contains code forthe C boot routine. The boot. ob j module is a member of 
the runtime-support object library, rts. lib. To use the module, simply use 
-c or -cr and include the library in the link: 

InkSO -c -1 rts.lib ... 
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The linker automatically extracts boot. ob j and links it in when you use the 
-c or -or option. 

When aC program begins running, it must execute boot. ob j first. The sym¬ 
bol c intoo is the starting point in boot.obj; if you use the -c or -or 
option, then _c_int o o is automatically defined as the entry point for the pro¬ 
gram. if your program begins running from reset, you should set up the reset 
vector to generate a branch to _c_int o o so that the TMS320C30 executes 
boot. ob j first. The boot. ob j module contains code and data for initializing 
the runtime environment; the module performs the following tasks: 

□ Sets up the system stack. 

□ Processes the runtime initialization tabie and autoinitiaiizes global 
variables (in the ROM model). 

□ Disables interrupts and calls main. 

□ Calls exit when main retums. 

Chapter 5 describes additional runtime-support functions that are included 
in rts.iib. If your program uses any of these functions, you must link 
rts. lib with your object files. 

2.9.2 Sample Linker Command File 

Figure 2-5 shows a typical linker command file that can be used to link a 
C program. The command file in this example is named link. cmd. 

Figure 2-5. An Example of a Linker Command File 


/* Linker command file link.cmd */ 


-c 

/* 

ROM autoinitialization model 

*/ 

-m example.map 

/* 

Create a map file 

*/ 

-o example.out 

/* 

Output file name 


main.obj 


First C module 

*/ 

sub.obj 

/* 

Second C module 

*/ 

asm.obj 

/* 

Assembly language module 

*/ 

-1 rts.iib 

/* 

Runtime-support library 

*/ 

-1 matrix.lib 

/* 

Object library 

*/ 


□ The command file first lists several linker options: 

-c tells the linker to use the ROM model of autoinitialization. 

-m tells the linker to create a map file; the map file in this example is 
named example .map. 

-o teils the linker to create an executable object module; the module 

in this exampie is named example.out. 
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□ Next, the command file lists all the object files to be linked. This C pro¬ 
gram consists of two C modules, main. c and sub. c, which were com¬ 
piled and assembled to create two object files called main.obj and 
sub.Obj. This example also links in an assembly language module 
called asm.obj. 

One of these files must define the symbol main, because boot. ob j calls 
main as the Start of your C program. All of these object files are linked in. 

□ Finally, the command file lists all the object libraries that the linker must 
search. (The libraries are specified with the -I linker option.) Because 
this is a C program, the runtime-support library rts.iib must be in¬ 
cluded. This program uses several routines from an archive library 
called matrix. lib, SO it is also named as linker input. Note that only the 
library members that resolve undefined references are linked in. 

To link the program using this command file, simply enter: 

lnk30 link.cmd 

This example uses the default memory allocation described in Chapter 9 of 
the TMS320C30 Assembly Language Tools User’s Guide. If you want to 
specify different MEMORY and SECTIONS definitions, refer to that user’s 
guide. 

2.9.3 Autoinitialization (RAM and ROM Models) 

The C compiler produces tables of data for autoinitializing global variables. 
Section 4.10.1.1, page 4-31, discusses the format of these tabies. These 
tables are in a named section called .cinit. The initialization tables can be 
used in either of two ways: 

□ RAM Model (-cr linker option) 

Global variables are initialized at load time. A loader copies the initial¬ 
ization data into the variables in the .bss section; thus, no runtime 
initialization is performed at boot time. This enhances performance by 
reducing boot time and saving memory used by the initialization tables. 

For more information about the RAM model, referto Section 4.10.1.2on 
page 4-32. 
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□ ROM Model (-c linker option) 

Global variables are initialized at run time. The .cinit section is ioaded 
into memory along with all the other sections. The iinker defines a spe- 
ciai symbol called cinit that points to the beginning of the tables in 
memory. When the program begins running, the C boot routine copies 
data from the tables into the specified variables in the .bss section. This 
allows initialization data to be stored in ROM and then copied to RAM 
each time the program is started. 

For more information about the ROM model, refer to Section 4.10.1.3 
on page 4-33. 

2.9.4 The -c and -cr Linker Options 

The following list outlines what happens when you invoke the iinker with the 
-c or -cr option. 

□ The symbol _c_intoo is defined as the program entry point; it identifies 
the beginning of the C boot routine in boot .obj. When you use -c or 
-cr, _c_intoo is automatically referenced; this ensures that boot. obj 
is automatically linked in from the runtime-support library rts. iib. 

□ The .cinit output section is padded with a termination record so that the 
loader (RAM model) or the boot routine (ROM model) knows when to 
stop reading the initialization tables. 

□ In the RAM model (-cr option): 

■ The linker sets the symbol cinit to-1. This indicates that the initial¬ 
ization tables are not In memory, so no initialization is performed at 
run time. 

■ The STYP_COPY flag (01 Oh) is set in the .cinit section header. 
STYP_COPY is the special attribute that tells the loader to perform 
autoinitialization directly and not to load the .cinit section into 
memory. The linker does not allocate space In memory for the .cinit 
section. 

□ In the ROM model (-c option), the linker defines the symbol cinit as 
the starting address of the .cinit section. The C boot routine uses this 
symbol as the starting point for autoinitialization. 
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2.10 Using the Archiver with C 

An archive file (or library) is a partitioned fiie that contains compiete fiies as 
members. The TMS320C30 archiver is a software utiiity that allows you to 
collect files into a single archive file. The archiver also allows you to manipu¬ 
late a library by adding members to it or by extracting, deleting, or replacing 
members. The TMS320C30 Assembly Language Tools User’s Gu/ofe con¬ 
tains complete instructions for using the archiver. 

After compiling and assembling multiple files, you can use the archiver to 
collect the object files into a library. You can specify an archive file as linker 
input. The linker is able to discern which files in a library resolve external ref¬ 
erences, and it links in only those library members that it needs. This is use¬ 
ful for creating a library of related functions; the linker links in only the func¬ 
tions that a program calls. The library rts. lib is an example of an object 
library. 

You can also use the archiverto collect C source programs into a library. The 
C compiler cannot choose individual files from a library; you must extract 
them before compiling them. However, this can be useful for managing files 
and for transferring source files between systems. The library rts. src is 
an example of an archive file that contains source files. 

For more information about the archiver, see the TMS320C30 Assembly 
Language Tools User’s Guide. 
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The C language that the TMS320C30 C compiler supports is based on the 
Unix System V C language that is described by Kernighan and Ritchie, with 
several additions and enhancements to provide compatibility with ANSI C. 
The most significant differences are: 

□ The data type enum has been added. 

□ A member of a structure can have the same name as a member of 
another structure (unique names aren’t required). 

□ Structures and unions can be passed as parameters to functions, re¬ 
turned from functions, and assigned directly. 

This chapter compares the two forms of C language and presents only the 
differences between them. The TMS320C30 C compiler supports standard 
Kernighan and Ritchie C except as noted. 

References to Kernighan and Ritchie’s C Reference Manual (Appendix A 
of The C Programming Language) are used throughout this chapter. 

Topics in this chapter include: 


Section Page 

3.1 Identifiers, Keywords, and Constants.3-2 

3.2 TMS320C30 C Data Types.3-4 

3.3 Object Alignment .3-6 

3.4 Expressions.3-6 

3.5 Declarations .3-7 

3.6 Intialization of Static and Global Variables.3-10 

3.7 Lexical Scope Rules . 3-10 

3.8 asm Statement.3-11 
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3.1 Identifiers, Keywords, and Constants 


K&R 2.2 Identifiers 

□ In TMS320C30 C, the first 31 characters of an identifier are 
significant (in K&R C, 8 characters are significant). This also applies 
to external names. 

□i Case is significant; uppercase characters are different from lower¬ 
case characters in all TMS320C30 tools. This also applies to external 
names. 


K&R 2.3 Keywords 

TMS320C30 C reserves three additional keywords: 

asm 

void 

enum 

K&R 2.41 Integer Constants 

Qi All integer constants are of type int (signed, 32 bits long) unless they 
have an Lor L/suffix. If the compiler encounters an invalid digit in a con¬ 
stant (such as an 8 or 9 in an octal constant), it issues a warning 
message. 

□ You can append a letter suffix to an integer constant to specify its type: 

■ Use Lfas a suffix to declare an unsigned integer constant. 

■ Use L as a suffix to declare a long integer constant. 

■ Combine the suffixes to declare an unsigned long integer constant. 

Suffixes can be upper or lower case. 

□ Here are some examples of Integer constants: 


1234; 

/* 

int 



OxFFFFFFFFu; 

/* 

unsigned 

int 

*/ 

OL; 

/* 

long int 



077613LU; 

/* 

unsigned 

long int 



K&R 2.43 Character Constants 

In addition to the escape codes listed in K&R, the TMS320C30 C compiler 
recognizes the escape code \v in character and string constants as a 
vertical tab character (ASCII code 11). 

Added Type - Enumeration Constants 

An enumeration constant is an additional type of integer constant that 
is not described by K&R. An identifier that is declared as an enumerator can 
be used in the same mannerthatan integer constant can be used. (For more 
information about enumerators, refer to Section 3.5 on page 3-7.) 


3-2 


TMS320C30 C Language 



Identifiers, Keywords, and Constants 

.V. .V.V.V.V.-. .v.-.y. .V.V.V.V.V.V.V. .v.v. • •. .v •. .v.-.v.v.v. .v.-.v.v.v. .v.v •. .v.v v.-. .-.v. .V/AVAV.VAV.V.V.V.V.V.V .W. .V.V.V.V. .V. V. V. .v.-.v V. .v.v.v. 


K&R 2.5 String Constants 

□ K&R C does not limit the length of string constants; however, 
TMS320C30 C limits the length of string constants to 255 bytes. 

□ Any characters that follow an embedded null byte within a string 
constant are ignored; in other words, the first null byte terminates a 
string. 

This does not apply to strings used to initialize arrays of characters. 

□ Identical string constants are stored as a single string, not as 

separate strings as in K&R C. 

This does not apply to strings used for autoinitialization of arrays of 
characters. 
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3.2 TMS320C30 C Data Types 

K&R 4.0 Added Type and Equivalent Types 

□ The char data type is signed. A separate type, unsigned char, is also 
supported. 

□ char, short, long, and int are functionally equivalent types. Any of these 
types can be declared unsigned. 

□ The properties of enum types are identical to those of unsigned int. 


K&R 4.0 


K&R 4.0 


Added Types 

□ An additional type, called void, can be used to declare a function that 
returns no value. The compiler checks that functions declared as void 
do not return values and that they are not used in expressions. Func¬ 
tions are the only type of objects that can be declared void. 

□ The compiler also supports a type that is a pointer to void (void *). An 
object of type void * can be converted to and from a pointer to an object 
of any other type without explicit conversions (casts). However, such a 
pointer cannot be used indirectly to access the object that it points to 


lout a conversion. For example. 


void 

*malloc ( ) 

/ 



char 

*c; 




int 

i; 




P = 

malloc 0; 


Legal 

*/ 

P = 

c; 

/* 

Legal, no cast needed 


P == 

&i; 

/* 

Legal, no cast needed 


c = 

malloc(); 

/* 

Legal, no cast needed 


i = 

^P/ 

/* 

Illegal, dereferencing 





void pointer 


i = 

* (int *) p; 

/ic 

Legal, dereferencing 



casted void pointer 




Derived Types 

TMS320C30 C allows any type declaration to have up to six derived types. 
Constructions such as pointer to, array of, and function returning can be 
combined and applied a maximum of six times. 

For example: 

int (* (*nC] []) 0 ) 0; 

translates as: 

1) an array of 

2) arrays of 

3) pointers to 

4) functions returning 

5) pointers to 

6) functions returning integers 
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It has six derived types, which is the maximum allowed. 

Structures, unions, and enumerations are not considered derived types for 
the purposes of these limits. 

An additional constraint is that the derived type cannot contain more than 
three array derivations. Note that each dimension in a multidimensional 
array is a separate array derivation; thus, arrays are iimited to three dimen¬ 
sions in any type definition. However, types can be combined using typedefs 
to produce any dimensioned array. 

For example, the following construction declares x as a four-dimensional 
array: 

typedef int dim2[][]; 
dim2 X[][]; 

Table 3-1. Summary of TMS320C30 Data Types (K&R 2.6) 


Type 

Size 

char 

8 bits, signed ASCil 

unsigned char 

8 bits, ASCII 

short 

16 bits 

unsigned short 

16 bits 

int 

32 bits 

unsigned int 

32 bits 

long 

32 bits 

unsigned long 

32 bits 

pointers 

32 bits 

float 

32 bits 

Range: +5.88 x 10(~39) through 
±1.70x1038 

double 

64 bits 

Range: +1.11 x 10(~308) through 

±8.99x10308 

enum 

1—32 bits 
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3.3 Object Alignment 

□ All objects except bit fields are aligned on 32-bit (one word) boundaries. 
Bitfields are always unsigned and can be from 1 to 32 bits in length. Ad¬ 
jacent fields are packed into adjacent bits of a word, but they do not 
overlap words; if a field would overlap into the next word, the entire field 
is placed into the next word. (A bit field never crosses a word boundary.) 
Fields are packed as they are encountered: the least significant bits of 
a structure word are filled first. 

□ When the compiler allocates space for a structure, it allocates as many 
words as are needed to hold all of the structure’s members. In an array 
of structures, each structure begins on a word boundary. 


3.4 Expressions 

Added type - Void Expressions 

A function of type void has no value (returns no value) and cannot be called 
in any way except as a separate statement or as the left operand of the 
comma operator. Functions can be declared or typecast as void. 

K&R 7.2 Unary Operators in Expressions 

The value yielded by the s/zeof operator is calculated as the total number 
of bits used to store the object divided by 32. (32 is the number of bits in a 
character.) Sizeof can be legally applied to bit fields. If the result is not an 
integer, it is rounded up to the nearest integer. For example, 

sizeof(int) == sizeof(short) == sizeof(char) == 
sizeof (long) == sizeof (float) == sizeof(double) == 1 
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3.5 Declarations 

K&R 8.1 Register Variables 

□ The TMS320C30 C compiler allows you to use up to eight register vari¬ 
ables in a function: 

■ Two TMS320C30 registers (R4 and R5) are reserved for the first 
two integer register variables in a function. 

■ Two registers (R6 and R7) are reserved for float or double register 
variables. 

■ Four registers (AR4—^AR7) are reserved for pointer register vari¬ 
ables. 

For more information about register variables, refer to Section 4.3, 
Register Conventions, on page 4-12. 

□ All integertypes (signed or unsigned), floats, doubles, and pointers, can 
be declared as registers. 

K&R 8.2 Type Specifiers in Declarations 

In addition to the type specifiers listed in K&R, objects can be declared with 
enum specifiers. 

TMS320C30 C allows more type name combinations than K&R C allows. 
The adjectives long and short can be used with or without the word int, the 
meaning is the same in either case. The word unsigned can be used in con¬ 
junction with any integer type or alone; if alone, int\s implied. Long float \s 
a synonym for double. Otherwise, only one type specifier is allowed in a dec¬ 
laration. 

K&R 8.4 Passing/Returning Structures to/from Functions 

Contrary to K&R, TMS320C30 C allows functions to return structures and 
unions. 

Structures and unions can be used as parameters to functions, can be di¬ 
rectly assigned, and can be returned from functions. 

K&R 10 External Definitions 

Formal parameters to a function can be declared as type struct, union, or 
enum (in addition to the normal function declarations) because TMS320C30 
C allows these types of objects to be passed to functions. 

K&R 8.5, K&R 14.1 Structure and Union Declarations 

Bit fields are limited to a maximum size of 32 bits. Any integer type can be 
declared as a field. Fields are always treated as unsigned, regardless of def¬ 
inition. 
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K&R states that structure and union member names must be mutually dis¬ 
tinct. in TMS320C30 C, members of different structures or unions can 
have the same name. However, this requires that references to the mem¬ 
ber be fully qualified through ail levels of nesting. 

TMS320C30 C allows assignment to and from structures, passing struc¬ 
tures as parameters, and returning structures from functions. 

K&R states that the compiler determines the type of structure reference by 
the member name. Because TMS320C30 C does not require member 
names to be unique, this statement does not apply. All structure references 
must be fully qualified as members of the structure or union in which they 
were declared. 

Added Type - Enumeration Declarations 

Enumerations allow the use of named integer constants in TMS320C30 C. 
The syntax of an enumeration declaration is similar to that of a structure or 
union. The keyword enum is substituted for struct or union, and a list of 
enumerators is substituted for the list of members. 

Enumeration declarations have a tag, as do structure and union declara¬ 
tions. This tag can be used in future declarations without repeating the entire 
declaration. 

The list of enumerators is simply a comma-separated list of identifiers. Each 
identifier can be followed by an equal sign and an integer constant. If no enu¬ 
merator is followed by an = sign and a value, then the first enumerator is 
assigned the value 0, the next is 1, the next is 2, etc. An identifier with an 
assigned value assumes that value, and subsequent enumerators continue 
counting by one from there. The assigned value can be negative, but count¬ 
ing still continues by positive one. 

Unlike structure and union members, enumerators share their name space 
with ordinary variables and, therefore, must not conflict with variables or 
other enumerators in the same scope. 

Enumerators can appear wherever integer constants are required and, 
therefore, can be used in arithmetic expressions, case expressions, etc. In 
addition, explicit integer expressions can be assigned to variables of type 
enum. The compiler does no range checking to insure the value will fit in the 
enumeration field. The compiler does, however, issue a warning message 
if an enumerator of one type is assigned to a variable of another. 
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Here’s an example of an enumeration declaration; 

enum color { 
red, 
blue, 

green = 10, 
orange, 
purple = -2, 
cyan } x; 

This statement declares x as a variable of type enum. The enumerators and 
their assigned values are: 

red: 0 
blue: 1 
green: 10 
orange: 11 
purple: -2 
cyan: —1 

32 bits are allocated for the variable x. Legal operations on these enumera¬ 
tors include: 

X = blue; 

X = blue + red; 

X = 100; 

i = red; /* assume i is an int 

X = i + cyan; 
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3.6 Initialization of Static and Global Variables 

K&R8.6 

An important difference between K&R C and TMS320C30 C is that external 
and static variables are not preinitialized to zero unless the program ex¬ 
plicitly does so or unless it is specified by the linker. 

If a program requires external and static variables to be preinitialized, you 
can use the linker to accomplish this. In the linker control file, use a fill value 
of 0 in the .bss section: 

SECTIONS { 

.bss { } = 0x00; 

} 


3.7 Lexical Scope Rules 

K&R 11.1 

The lexical scope rules stated in K&R apply to TMS320C30 C also, except 
that structures and unions each have distinct name spaces for their mem¬ 
bers. In addition, the name space of both enumeration variables and enu¬ 
meration constants is the same as for ordinary variables. 
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3.8 asm Statement 

Additional Statement 

TMS320C30 C has another statement not mentioned in K&R: the asm 
statement. The compiler copies asm statements from the C source directly 
into the assembly language output file. The syntax of the asm statement is: 

asm(”assembler text ); 

The assembiertext must be enclosed in double quotes. All the usual charac¬ 
ter string escape codes retain their definitions. The assembiertext is copied 
directly to the assembler source file. Note that the assembler source state¬ 
ment must begin with a label, a blank, or a comment indicator (asterisk or 
semicolon). 

Each asm statement injects one line of assembly language into the compiler 
output. A series of asm commands places the statements sequentially into 
the output with no intervening code. 

Asm statements do not follow the syntactic restrictions of normal statements 
and can appear anywhere in the C source, even outside blocks. However, 
they are ignored when they appear in a list of declarations. 


Note: 

Be extremely careful not to disrupt the C environment with asm commands. 
The compiler does not check the inserted instructions. Inserting jumps and 
labels into C code can cause unpredictable results in variables manipulated 
in or around the inserted code. The asm command is provided so you can 
access features of the hardware, which by definition C is unable to access. 
Specifically, do not use this command to change the value of a C variable; 
however, you can use it safely to read the current value of a variable. 

I_I 


The asm command is very useful in the context of register variables. A regis¬ 
ter variable is a variable in a C program that is declared to reside in a ma¬ 
chine register. The TMS320C30 C compiler allows up to 8 machine registers 
to be allocated to register variables. These 8 registers, combined with the 
asm command, provide a means of manipulating data independently of the 
C environment. 
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Runtime Environment 


This chapter describes the TMS320C30 C runtime environment. To ensure 
successful execution of C programs, it is critical that all runtime code main¬ 
tain this environment. If you write assembly language functions that 
interface to C code, follow the guidelines in this section. 

Topics in this chapter include: 


Section Page 

4.1 Memory Model. 4-2 

4.2 Object Representation . 4-8 

4.3 Register Conventions. 4-12 

4.4 Function Structure and Calling Conventions. 4-15 
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4.6 Interrupt Handling . 4-23 

4.7 Expression Analysis . 4-25 

4.8 Runtime-Support Math Routines. 4-26 

4.9 Optimization. 4-28 

4.10 System Initiaiization. 4-30 
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4.1 Memory Model 

The C compiler treats memory as a single linear block of memory that is par¬ 
titioned into subblocks of code and data. Each block of code or data that a 
C program generates will be placed in its own contiguous space in memory. 
The compiler assumes that the full 24-bit address space is available in target 
memory. 

Note that the linker, not the compiler, defines the memory map and allo¬ 
cates code and data into target memory. The compiler assumes nothing 
about the types of memory that are available, about any locations that are 
not available (holes), or about any locations that are reserved for I/O or con¬ 
trol purposes. The compiler produces relocatable code, which allows the 
linker to allocate code and data into the appropriate memory spaces. For 
example, you can use the linker to allocate global variables into fast internal 
RAM, or to allocate executable code into internal ROM. 

4.1.1 Sections 

The compiler produces five relocatable blocks of code and data; these 
blocks, called sections, can be allocated into memory in a variety of ways 
to conform to a variety of system configurations. For more information about 
sections, read Chapter 3, Introduction to Common Object File Format, of the 
TMS320C30 Assembly Language Tools User’s Guide. 

There are two basic types of sections: 

□ initiaiized sections contain data tables or executable code. The C 
compiler creates two initialized sections, .text and .cinit. 

■ The .text section is an initialized section that contains all the 
executable code as well as string literals. 

■ The .cinit section is an initialized section that contains tables for 
initializing variables and constants. 

□ Uninitiaiized sections reserve space in memory (usually in RAM). A 
program can use this space at run time for creating and storing vari¬ 
ables. The C compiler creates three uninitialized sections, .bss, .stack, 
and .sysmem. 

■ The .bss section is an uninitialized section. It reserves space for 
global and static variables, and in the small model (described in 
Section 4.1.2), it reserves space for tables of long immediate con¬ 
stants. At program startup time, the C boot routine copies data out 
of the .cinit section (which may be in ROM) and stores it in .bss. 

■ The .stack section is an uninitialized section. It allocates memory 
for the system stack, which is used to pass arguments to functions 
and to allocate local variables. 
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■ The .sysmem section is an uninitialized section. It allocates 
memory for use by the dynamic memory functions maiioc, caiioc, 
and realloc. If a C program does not use these functions, then the 
compiier does not create the .sysmem section. 

Note that the assembler creates an additionai section caiied .data; the C 
compiler does not use this section. The iinker takes the individual sections 
from different modules and combines sections with the same name to create 
six output sections. The complete program is made up of these five output 
sections, plus the assembler’s .data section. You can place these output 
sections anywhere in the address space, as needed, to meet system re¬ 
quirements. The .text, .cinit, and .data sections are usually linked into either 
ROM or RAM. The .bss, .stack, and .sysmem sections should be linked into 
some type of RAM. 

For more information about allocating sections into memory, refer to 
Chapter 9, Linker Description, in the TMS320C30 Assembly Language 
Tools User’s Guide. 

4.1.2 Big and Small Memory Models 

The compiler supports two memory models that affect the treatment of the 
.bss section; 

□ The small memory model, which is the default model, requires the 
entire .bss section to fit in a single 64K memory page (65,536 words). 
This means that the total space for all static and global data in the pro¬ 
gram must be less than 64K and that the .bss section cannot span any 
64K address boundaries. The compiler sets the Data Page Pointer reg¬ 
ister (DP) during runtime initialization to point to the beginning of .bss. 
Then, the compiler can access all objects in .bss (global and static vari¬ 
ables, plus constant tables) with direct addressing ((©symbol) without 
modifying the DP. 

□ The big memory model does not restrict the size of .bss; unlimited 
space is available for global and static data. However, when the 
compiler accesses any global or static object that is stored in .bss, it 
must first ensure that the DP correctly identifies the memory page 
where the object is stored. To accomplish this, the compiler must explic¬ 
itly set the DP register (using an LDP instruction) each time a global or 
static object is accessed. This task incurs one extra instruction word (for 
the LDP instruction) and three additional cycles (one to execute the LDP 
and a two-cycle pipeline delay if the object is accessed by the next 
instruction). 
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Here’s an example of assembly language code that uses the LDP in¬ 
struction to set up the DP register before accessing a global variable. 

*** Assume that _x is a global variable 
LDP _x ; 1 extra word, 1 cycle 

LDI @__x,R0 ; 3 cycles (2 pipeline delays) 

To use the big modei, invoke the compiler with the-mb option; for more 
information, refer to Section 2.4 on page 2-6. 

Neither model restricts the size of the .text or .cinit sections. 

Both models restrict the size of a single function to 32K (32768 words of 
code) or less; this ailows the compiler to generate relative conditional jumps 
over the entire range of a function. 

I-1 

Note: 

Be sure ali code in the system is compiled under the same model. 
Mixed-model code will not run. The runtime-support library that is provided 
with the compiler (rts. lib) is complied with the small model. To use the 
library under the big model, you must: 

1) Extract all the source files from the source archive rts. src. 

2) Recompile these extracted files; be sure to invoke the code generator 
with the -b option. 

3) Archive the object files into a new library. 

I_I 

Neither model restricts the size of the dynamic memory area in the .sysmem 
section because dynamically allocated objects are accessed with indirect, 
rather than direct, addressing. Thus, if you have large data objects, it is ad¬ 
vantageous to allocate them dynamically rather than declare them as static 
or global variables; for more information, refer to Section 4.1.4 on page 
4-6. 

Under the small model, be careful when linking the .bss section; it must be 
less than 64K words and it cannot span any 64K page boundaries. Neither 
the compiler nor the linker checks for restrictions on .bss against the model 
used. If you choose to use the small model and your code does not conform 
to small-model restrictions, the code will not run. If you want to verify that 
the .bss section is fully contained within a 64K memory page, check the link 
map after linking. 
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4.1.3 C System Stack 

The C compiler uses a stack to: 

□ Allocate local variables, 

□ Pass arguments to functions, and 

□ Save temporary results. 

The compiler uses two registers to manage the stack: 

SP is the stack pointer; it marks the top of the stack. 

AR3 is the frame pointer (FP); it points to the beginning of the current 
local frame. (A local frame is an area on the stack that is used for stor¬ 
ing arguments and local variables.) Each function invocation causes 
a new local frame to be created at the top of the stack. 

The C environment automatically manipulates these registers when a C 
function is called. If you interface assembly language routines to C, be sure 
to use the registers in the same way that the C compiler uses them. 

The C initialization module, boot. asm, allocates memory for the stack in an 
uninitialized, named section called .stack. This module also defines a con¬ 
stant named stack size that determines the size of the stack. The default 
stack size is 400h (1K words); this size allows the stack to fit into one of the 
on-chip RAM blocks. You can change the amount of memory that is re¬ 
served for the stack by following these steps: 

1) Extract boot. asm from the source library rts. src. 

2) Edit boot. asm; Change the value of the constant stack_si ze to the de¬ 
sired stack size. 

3) Reassemble boot. asm and replace the resulting object file, boot. ob j, 
in the object library rts. lib. 

4) Replace the copy of boot . asm that’s in rts . src with the new, edited 
version. 

At system initialization, the SP is set to a designated address for the bot- 
tom-of-stack. This address is the first location in the .stack section. Thus, 
the actual position of the stack is determined at link time, because the 
position of the stack depends on where the .stack section is allocated. If you 
allocate the stack as the last section in memory (highest address), the stack 
has unlimited space in which to grow (within the limits of system memory). 
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Note: 

The compiler provides no means to check for stack overflow during compi¬ 
lation or at run time. If the stack overflows, your system will probably crash. 
Be sure that you allow enough space for the stack to grow; either set 
sTACK_sizE to an appropriate amount or allocate the .stack section last. 

I_I 


4.1.4 Dynamic Memory Allocation 

The runtime-support library supplied with the compiler contains several 
functions (such as maiioc, caiioc, and reaiioc) that allow you to dynami¬ 
cally allocate memory for variables at run time. This is accomplished by 
declaring a large memory pool, or heap, and then using the functions to allo¬ 
cate memory from the heap. Dynamic allocation is not a standard part of the 
C language: it is provided by standard runtime-support functions. 

An assembly language module called sysmem.asm defines this memory 
pool as an uninitialized, named section called .sysmem. The module also 

defines a constant named_ s ysmem_s i ze that determines the size of the 

memory pool; the default size is 800h (2K words). You can change the size 
of the memory pool by following these steps: 

1) Extract sysmem.asm from the source library rts. src. 

2) Edit sysmem. asm; Change the value of the constant _ _ sysmem_size 
to the desired memory pool size. 

3) Reassemble sysmem.asm and replace the resulting object file, 
sysmem.obj, in the Object library rts. lib. 

4) Replace the copy of sysmem. asm that’s in rts . src with the new, edited 
version. 

Dynamically allocated objects are not addressed directly (they are always 
accessed with pointers), and the memory pool is in a separate section; 
therefore, the dynamic memory pool can have an unlimited size, even in the 
small memory model. The size of the pool does not affect the 64K limit on 
global and static variables. This allows you to use the more efficient small 
memory model even if you declare large data objects. To conserve space 
in .bss, you can allocate large arrays from the heap instead of declaring 
them as global or static. For example, instead of a declaration such as: 

struct big table[10000]; 

use a pointer, and call the maiioc function: 
struct big *table; 

table= (struct big *)maiioc(10000 *sizeof(struct big)); 
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Note: 

If you don’t use dynamic allocation—^that is, if you don’t use caiioc, 
maiioc, and similar functions—then it is not necessary to allocate the .sys- 
mem section at link time. 

I_I 


4.1.5 RAM and ROM Models 

The C compiler produces code that is suitable for use as firmware in a 
ROM-based system. In such a system, the initialization tables in the .cinit 
section are stored in ROM. At system initialization time, the C boot routine 
copies data from these tables (in ROM) to the initialized variables in .bss (in 
RAM). 

In situations where a program is loaded directly from an object file into 
memory and then run, you can avoid having the .cinit section occupy space 
in memory. Your loader can read the initialization tables directly from the ob¬ 
ject file (instead of from ROM) and perform the initialization directly at load 
time (instead of at run time). You can specify this to the linker hy using the 
-cr linker option. 

For more information about autoinitialization, refer to Section 4.10 on page 
4-30. 
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4.2 Object Representation 

4.2.1 Storage of Data Types 

□i All basic types are 32-bits wide and stored in individual words of 
memory. No packing is performed, except for bit fields, which are 
packed into words. Bit fields are allocated from the LSB to the MSB in 
the order in which they are declared. 

□ No object has any type of alignment requirement: any object can be 
stored on any 32-bit word boundary. Objects that are members of struc¬ 
tures or arrays are stored just as they are individually. Members are not 
packed into structures or arrays (uniess the members are bit fields). 

□i The integral types char, short, int, and long are all equivalent, as are 
their unsigned counterparts. Objects of type enum are also represented 
in 32-bit words. 

□ The float and double types are equivalent: both types specify objects 
represented in the TMS320C30’s 32-bit floating-point format. 

4.2.2 Long Immediate Values 

The TMS320C30 instruction set has no immediate operands that are longer 
than 16 bits. The compiler occasionally needs to use constants that are too 
long to be immediate operands. This occurs with signed integer constants 
that have more than 15 significant non-sign bits, with unsigned integers that 
have more than 16 significant bits, or with floating-point constants that have 
more than 11 significant non-sign bits in the mantissa. The compiler uses 
the .word and .float assembler directives to build a table in memory that con¬ 
tains all such constants. Constants in the table are then accessed like global 
variables, using direct addressing. Section 4.2.5, page 4-10, describes the 
structure of the constant table. 

4.2.3 Addressing Global Variables 

The compiler generates the addresses of global or static symbols for index¬ 
ing arrays or manipulating pointers. Because these addresses may be up 
to 24 bits wide, and immediate operands are limited to 16 bits, these ad¬ 
dresses are treated like long constants as described in Section 4.2.2. The 
compiler generates addresses into the constant table using the .word as¬ 
sembler directive. Section 4.2.5, page 4-10, describes the structure of the 
constant table. 
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4.2.4 Character String Constants 

In C, a character string constant can be used in one of two ways: 

□ it can initialize an array of characters; for example: 

char s[] = "abc"; 

When a string is used as an initializer, it is simply treated as an initialized 
array: each character is a separate initializer. For more information 
about autoinitialization, refer to Section 4.10 on page 4-30. 

□ It can be used as a pointer; for example: 

printf("abc"); 

When a string is used as a pointer, the string itself is defined in the .text 
section using the .byte assembler directive, along with a unique label 
that points to the string; the terminating 0 byte is included. For example, 
the following line defines the string abc, along with the terminating byte; 
the label sls points to the string: 

SL5 .byte "abc",0 

String labels have the form SLn, where n is a number assigned by the 
compiler, beginning with 0 and increasing by 1 for each defined string. 
All strings used in a source module are defined at the end of the com¬ 
piled assembly language module. 

The label SLn represents the address of the string constant (a pointerto 
the string). Like all addresses of static objects, this address must be 
stored in the constant table in order to be accessed. Thus, in addition to 
storing the string itself in the .text section, the compiler uses the follow¬ 
ing directive statement to store the string’s address in the constant 
table: 


.word SLn 

If the same string is used more than once within a source module, the 
string will not be duplicated in memory. All uses of an identical string 
constant share a single definition of the string. 

I---1 

Note: 

Each source module can have a maximum of 400 unique string constants; 
the code generator aborts with an error message if this limit is exceeded. 

I_I 
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Because strings are stored in .text (possibly ROM) and shared, it is bad 
practice for a program to modify a string constant. The following code is an 
example of incorrect string use: 

char *a = "abc"; 

a[l] = 'x'; /* Incorrect! */ 


4.2.5 The Constant Table 


The constant table contains definitions of all the objects that the compiler 
must access, but are too wide to be used as immediate operands. Such ob¬ 
jects include; 

□ Integer constants that are wider than 16 bits. 

□ Floating-point constants that have exponents larger than 4 bits or man¬ 
tissas larger than 11. 

Q Addresses of global variables. 

□ Addresses of string constants. 

The constant table is simply a block of memory that contains all such 
objects. The compiler builds the constant table at the end of the source mod¬ 
ule by using the .word and .float assembler directives. Each entry in the table 
occupies one word. The label const points to the beginning of the table. For 
example: 


CONST: 


.word 011223344h ;32 bit constant 

.float 3.1459265 /floating-point constant 

.word _globvar /address of global 

.word SL23 /address of string 


Objects In the table are accessed with direct addressing: for example: 


LDI @CONST+offset,RO 

In this example, offset Is the Index into the constant table of the required 
object. As with string constants, identical constants used within a source 
module share a single entry in the table. 

In the big memory model, the constant table is built in the .text section (and 
is not copied into RAM). The compiler must insure that the DP register is cor¬ 
rectly loaded before accessing an object in the table, just as with accessing 
global variables. This requires an LDP instruction before each access to the 
constant table. 


The small model, however, avoids the overhead of loading DP by requiring 
that all directly addressable objects, including all global variables as well as 
the constant table, are stored in the same memory page. Of course, global 
variables must be stored in RAM. Forthe code to be ROM-able, the constant 
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table must be in ROM. In order to get them on the same page, the boot rou¬ 
tine must copy the constant table from permanent storage in ROM to the 
global page in RAM. The compiler accomplishes this by placing the data for 
the constant table in the .cinit section and allocating space for the table itself 
in .bss. Thus, the table is automatically built into RAM through the autoinitial¬ 
ization process. 

As with all autoinitiaiization, you can avoid the extra use of memory required 
for the .cinit section by using the -cr linker option and using a smart loader 
to perform the initialization directly from the object file. For more information 
about autoinitiaiization, refer to Section 4.10 on page 4-30. 

I-1 

Note: 

1) The total size of the constant table in one module is limited to 1000 en¬ 
tries. If this limit is exceeded, the code generator aborts with an error 
message. 

2) Note that the small memory model restricts the total size of the global 
data page, including the constant tables, to 64K words. 
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4.3 Register Conventions 

Strict conventions associate specific registers with specific operations in the 
C environment. If you plan to interface assembly language routines to a C 
program, you must follow these register conventions. 

The C compiler uses the following registers: 

Table 4-1. List of the Registers the Compiler Uses 


Register 

Description 

RO 

Integer and floating-point expression register, also, scalar return 
values 

R1 

Integer and floating-point expression register 

R2 

Integer and floating-point expression register 

R3 

Integer and floating-point expression register 

R4 

Integer register variable 

R5 

Integer register variable 

R6 

Floating-point register variable 

R7 

Floating-point register variable 

ARO 

Pointer expression register 

AR1 

Pointer expression register 

AR2 

Pointer expression register 

AR3 

Frame pointer (FP) 

AR4 

Pointer register variable 

AR5 

Pointer register variable 

AR6 

Pointer register variable 

AR7 

Pointer register variable 

IRO 

Used for extended addressing on local frame 

IR1 

Used for extended addressing on local frame 

SP 

Stack pointer 


4.3.1 Expression Analysis Registers 

The compiler uses registers RO—R3 and ARO—AR2 to evaluate expres¬ 
sions and store temporary results. The compiler keeps track of the current 
contents of each register and attempts to allocate registers for expressions 
in a way that preserves useful contents In the registers whenever possible. 
This allows the compiler to reuse register data and take advantage of the 
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TMS320C30’s efficient register addressing modes and to avoid unneces¬ 
sary accesses of variables and constants. 

When a function is called, the compiler forgets the contents of the expres¬ 
sion registers. The contents of any register that is being used for temporary 
storage is saved off to the local frame before the function is called. This pre¬ 
vents the called function from ever having to save and restore expression 
registers. 

If the compiler needs another register for an expression evaluation, a regis¬ 
ter that is being used for temporary storage can be saved on the local frame 
and used for the expression analysis. Typical expressions seldom require 
more than four expression registers. 

4.3.2 Return Values 

When a value of any scalar type (integer, pointer, or floating-point) is 
returned from a function, the value is placed in register RO when the function 
returns. 

4.3.3 Register Variables 

Specific registers are reserved for variables that are declared with the regis¬ 
ter storage class specifier. The register designation tells the compiler to 
store the associated variable in a register if possible, for efficient access. 
Register storage can be specified for any type of automatic variables, both 
function arguments and local variables. There are several registers for each 
type of register variable: 


Register 

Description 

R4, R5 

are used for /nfeger register variables. 

R6, R7 

are used for floating-point register variables. 

AR4—AR7 

are used for pointer register variables. 


These registers are allocated in the order that they are declared; for exam¬ 
ple, the first integer variable declared as register is assigned to R4, and the 
second is assigned to R5. If a function declares more register variables than 
the number of registers that are available for that type, the excess variables 
are treated as automatic variables. 

Using register variables can significantly increase the efficiency of a func¬ 
tion, especially when values are frequently assigned to a particular variable 

(var = . . .). 

Any function that uses register variables must save the contents of each 
register used on entrance to the function and restore them on exit. This 


4-13 



Register Conventions 


ensures that a called function does not disrupt the register variables of the 
calling function. 

Unused register variables can be freely manipulated using inline assembly 
language. 

4.3.4 Other Registers 

□ The stack pointer (SP) and frame pointer (AR3) are used to manage the 
local frame. 

□ The page pointer (DP) is used to access global and static variables. 
Called functions must preserve the values in these registers. 

□ Index registers IRQ and IR1 are used for indirect addressing when an 
offset of more than 8 bits (±255) is required. They are treated like ex¬ 
pression registers and need not be saved by called functions. 

□ The block-repeat registers (RS, RE, and RC) are used to copy struc¬ 
tures. They need not be saved by called functions. 
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4.4 Function Structure and Calling Conventions 

The C compiler imposes a strict set of rules on function calls. Except for 
special runtime-support functions, any function that calls or is called by a C 
function must follow these rules. Failure to adhere to these rules can disrupt 
the C environment and cause the program to fail. 

Figure 4-1 illustratesatypicalfunctioncall. In this example, parameters are 
passed to the function and the function uses local variables. 

Figure 4-1. Stack Use During a Function Caii 
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4.4.1 Responsibilities of a Calling Function 

A function performs the following tasks when it calls another function. 

1) The caller pushes the arguments on the stack in reverse order (the right¬ 
most declared argument is pushed first and the leftmost is pushed last). 
This places the leftmost argument at the top of the stack when the 
function is called. 

2) The caller calls the function. 

3) When the called function is complete, the caller pops the arguments off 
the stack with the following instruction; 

soBi n,SP 

n is the number of argument words that were pushed. 
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4.4.2 Responsibilities of a Called Function 

A called function must perform the following tasks. 

1) If the called function modifies any of the following registers, it must save 
them on the stack. 


Save as integers 

Save as floating-point 

R4 R5 AR4 

R6 

AR5 AR6 AR7 

R7 

FP 



The called function may modify any other registers without saving them. 

2) It executes the code for the function. 

3) It restores all saved registers. 

4) If the function returns an integer, pointer, or float, it places the return 
value in RO. If the function returns a structure, refer to Section 4.4.5 on 
page 4-17. 

4.4.3 Setting Up the Local Frame 

Called C functions perform additional actions in order to manage the local 
frame. Note that if the function has no local variables, and no need for local 
temporary storage, these actions are not taken. 

1) The called function sets up the local frame; this is the first action taken 
by the called function. The iocal frame is allocated as follows: 

a) The old frame pointer is saved on the stack. 

b) The new frame pointer is set to the current SP. 

c) The frame is allocated by adding its size to the SP. 

2) Before returning, the called function deallocates the frame by subtract¬ 
ing its size from SP and restores the old FP by popping it. 

4.4.4 Accessing Arguments and Local Variables 

A function accesses its arguments and local variables indirectly through the 
FP, which always points to the the bottom of the local frame. Because the 
FP actually points to the old FP, the first local variable is addressed as 
*+FP (1 ). Other local variables are addressed with increasing offsets, up to 
a maximum of 255. Local objects with offsets larger than 255 are accessed 
by first loading their offset into an index register (IRn) and addressing them 
as*+FP(iRn). 
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Arguments are addressed in a similar way, but with negative offsets from 
the FP. The return address is stored at the location directly below the FP, 
so the first argument is addressed as *-fp (2) . Other arguments are ad¬ 
dressed with increasing offsets, up to a maximum of 255 words. The IR 
registers are also used to access arguments with offsets larger than 255. 

I-1 

Note: 

It is best to avoid using locals and arguments with offsets larger than 255 
words. The sequence used to access such variables is: 

LDI offset, IRJI 

*+FP(IRn), ... 

This sequence incurs one additional instruction and three additional clock 
cycles each time it is used. If you must use a larger local frame, try to put 
the most frequently used variables within the first 255 words of the frame. 

I_I 


4.4.5 Returning Structures from Functions 

A special convention applies to functions that return structures. The caller 
allocates space for the structure and then passes the address of the return 
space to the called function in register ARO. To return a structure, the called 
function then copies the structure to the memory block that ARO points to. 

In this way, the caller can be “smart” about telling the called function where 
to return the structure. For example. In the statement s = f (), where s is 
a structure and f is a function that returns a structure, the caller can simply 
place the address of s in ARO and call f . Function f then copies the return 
structure directly into s, performing the assignment automatically. 

If the caller does not use the return value, ARO is set to 0. This directs the 
called function not to copy the return structure. 

You must be careful to properly declare functions that return structures both 
at the point where they are called (so the caller properly sets up ARO) and 
where they are defined (so the function knows to copy the result). 
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4.5 Interfacing C with Assembly Language 

There are three ways to use assembly language in conjunction with C code: 

□ Use separate modules of assembled code and link them with compiled 
C modules (see Section 4.5.1). This is the most versatile method. 

□ Use inline assembly language that is imbedded directly in the C source 
(see Section 4.5.2, page 4-22). 

□ Modify the assembly language code that the compiler produces (see 
Section 4.5.3, page 4-22). 

4.5.1 Assembly Language Modules 

Interfacing with assembly language functions is straightforward if you follow 
the calling conventions defined in Section 4.4 and the register conventions 
defined in Section 4.3. C code can access variables and call functions that 
are defined in assembly language, and assembly code can access C vari¬ 
ables and call C functions. 

Follow these guidelines to interface assembly language and C: 

1) All functions, whether they are written in C or assembly language, must 
follow the conventions outlined in Section 4.4, page 4-15). 

2) You must preserve any dedicated registers that are modified by a func¬ 
tion; dedicated registers include: 

Dedicated Registers 

R4 R5 R6 R7 

AR4 AR5 AR6 AR7 

SP FP (AR3) 

All registers are saved as integers except R6 and R7, which are saved 
as floating-point values. Note that if the SP is used normally, it does not 
need to be explicitly preserved. In other words, the assembly function is 
free to use the stack as long as anything that is pushed is popped back 
off before the function returns (thus preserving SP). 

All other registers (such as expression registers, index registers, status 
registers, and block repeat registers) are not dedicated and can be used 
freely without first being saved. 

3) Interrupt routines must save ail the registers they use. Expression reg¬ 
isters RO—R3 must be saved as complete 40-bit values, because they 
may contain either integers or floating-point values when the interrupt 
occurs. For more information about interrupt handling, refer to Section 
4.6 on page 4-23. 
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4) When calling a C function from assembiy language, push any argu¬ 
ments on the stack in reverse order. Pop them off after calling the func¬ 
tion. When calling C functions, remember that only the dedicated regis¬ 
ters listed above are preserved. C functions can change the contents 
of any other register. 

5) Functions must return values correctly according to their C declara¬ 
tions. Integers, pointers, and floating-point values are returned in 
register RO, and structures are returned as described in Section 4.4.5 
on page 4-17. 

6) No assembly module should use the .cinit section for any purpose other 
than autoinitialization of global variables. The C startup routine in 
boot. asm assumes that the .cinit section consists entirely of initializa¬ 
tion tables. Disrupting the tables by putting other information in .cinit can 
cause unpredictable results. 

7) The compiler appends an underscore ( J to the beginning of all identifi¬ 
ers. In assembly language modules, you must use a prefix of for all 
objects that are to be accessible from C. For example, a C object named 
X is called _x in assembly. For identifiers that are to be used only in an 
assembly language module or modules, any name that does not begin 
with a leading underscore may be safely used without conflicting with 
a C identifier. 

8) Any object or function declared in assembly that is to be accessed or 
called from C must be declared with the .global directive in the assem¬ 
bler. This defines the symbol as external and allows the linker to resolve 
references to it. 

Likewise, to access a C function or object from assembly, declare the C 
object with .global. This creates an undefined external reference that 
the linker will resolve. 

4.5.1.1 An Example of an Assembly Language Function 

The example in Section 4.2 illustrates a C function called main, which calls 
an assembly language function called asmfunc. The asmfunc function takes 
its single argument, adds it to the C global variable called gvar, and returns 
the result. 
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Figure 4-2. An Assembly Language Function 


(a) C program 

extern int asmfunc0; /* declare external asm function */ 

int gvar; /* define global variable */ 

main() 

{ 

int i; 

i = asmfunc (i); /* call function normally */ 

} 


(b) Assembly language program 


FP .set 

AR3 

/ 

FP is AR3 

.global 

asmfunc 

f 

Declare external function 

.global 

_gvar 

f 

Declare external variable 

asmfunc: 




PUSH 

FP 

} 

Save old FP 

LDI 

SP,FP 

; 

Point to top of stack 

LDI 

*-FP(2),R0 

/ 

Load argument into RO 

LDP 

_gvar 

/ 

Set DP to page of gvar 



/ 

(BIG MODEL ONLY) 

ADD I 

@ gvar,R0 

/ 

Add gvar to argument in RO 

POP 

FP 

/ 

Restore FP 

RETS 





In the C program in Figure 4-2, the extern declaration of asmfunc is option¬ 
al because the function returns an int. Like C functions, assembly functions 
need be declared only if they return non-integers. 

In the assembly language code in Figure 4-2, note the underscores on all 
the C symbol names. Note also that the DP needs to be set only when ac¬ 
cessing global variables in the big model. For the small model, the LDP 
instruction that loads the page pointer can be omitted. 

4.5.1.2 Defining Variables in Assembly Language 

It is sometimes useful for a C program to access variables that are defined 
in assembly language. Accessing uninitialized variables from the .bss sec¬ 
tion is straightforward; 

□ Use the .bss directive to define the variable. 

Q Use the .global directive to make the definition external. 

□ Remember to precede the name with an underscore. 

□ In C, declare the variable as extern and access it normally. 
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Figure 4-3 shows an example for accessing a variable defined in .bss. 

Figure 4-3. Accessing a Variabie Defined in .bss from C 


(a) Assembly Language Program 


; Note the use of underscores 
; in the following lines 
.bss _var,1 ; Define the variable 

.global _var ; Declare it as external 



(b) C Program 


extern int var; 

/VC 

External variable 

VC/ 

var = 1; 

/VC 

Use the variable 



If a variable is not defined in the .bss section, it is more difficult to access 
it from C. A common situation is a lookup table defined in assembly that you 
don’t want to put in RAM. In this case, you must define a pointer to the object 
and access it indirectly from C. 

The first step is to define the object. It is helpful, but not necessary, to put 
it in its own initialized section. Declare a global label that points to the begin¬ 
ning of the object. 

The object can be linked anywhere into the memory space. To access it in 
C, you must declare an additional C variable to point to the object. Initialize 
the pointer with the assembly language label declared for the object: re¬ 
member to remove the underscore. 

Figure 4-4 shows an example for accessing a variable that is not defined 
in .bss. 

Figure 4-4. Accessing a Variabie that is not Defined in .bss from C 
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Note that a reference such as sine [4] will not work because the object is 
not in .bss and a direct reference such as this generates incorrect code. 

4.5.2 Inline Assembly Language 

Within a C program, you can use the asm statement to inject a single line 
of assembly language into the assembly language file that the compiler 
creates. A series of asm statements places sequential lines of assembly 
language into the compiler output with no intervening code. For more infor¬ 
mation about the asm statement, refer to Section 3.8 on page 3-11. 


Note: 

Inserting jumps or labels into C code may produce unpredictable results by 
confusing the register-tracking algorithms that the code generator uses. 
The asm statement is provided so that you can access features of the hard¬ 
ware which would be otherwise inaccessible from C. 

Do not change the value of a C variable; however, you can safely read the 
current value of any variable. 

In addition, do not use the asm statement to insert assembler directives that 
would change the assembly environment. 

i_I 


The asm statement is also useful for inserting comments in the compiler out¬ 
put; simply start the assembly code string with an asterisk (*) as shown be¬ 
low: 

asm("**** this is an assembly language comment"); 

4.5.3 Modifying Compiler Output 

You can inspect and change the assembly language output that the compiler 
produces by compiling the source and then editing the output file before 
assembling it. The note in Section 4.5.2 about disrupting the C environment 
also apply to modification of compiler output. 
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4.6 interrupt Handling 

As long as you follow the guidelines in this section, C code can be inter¬ 
rupted and returned to without disrupting the C environment. When the C 
environment is initialized, the startup routine does not enable or disable 
interrupts. (If the system is initialized via a hardware reset, interrupts are dis¬ 
abled). If your system uses interrupts, it is your responsibility to handle any 
required enabling or masking of interrupts. Such operations have no affect 
on the C environment and can be easily incorporated with asm statements. 

4.6.1 Saving Registers During interrupts 

When C code is interrupted, the interrupt routine must preserve the contents 
of all machine registers. A problem arises with the extended-precision reg¬ 
isters used for expression analysis (RO—R3): these registers can contain 
either integer or floating-point values, and an interrupt routine cannot deter¬ 
mine the type of value in a register. Thus, an interrupt routine must preserve 
all 40 bits of any of these registers that it modifies. This involves saving both 
the integer part (lower 32 bits) and the floating-point part (upper 32 bits). You 
can avoid this problem by not using these registers for handling interrupts. 

The following code saves and restores all 40 bits of a register: 


PUSH 

RO 

; Save bottom 

32 

bits 

PUSHF 

RO 

; Save top 32 

bits 

POPF 

RO 

; Restore top 

32 

bits 

POP 

RO 

; Restore bottom 

32 bits 


If the interrupt routine modifies R6 or R7, which are reserved for the float¬ 
ing-point register variables, only the floating-point contents must be 
preserved. These registers can contain only floating-point values. 

Any other registers that are modified by the interrupt routine can contain in¬ 
tegers (or pointers) only, so only the integer part (lower 32 bits) must be 
preserved. 

4.6.2 Using C Interrupt Routines 

Interrupts can be handled directly with C functions by using a special naming 
convention. C interrupt functions have names with the following format: 

c_intnn 

nn is a two-digit interrupt number between 00 and 99 (for example, a valid 
interrupt routine name is c_intoi). By following this convention for naming 
interrupt routines, you assure that the compiler uses the special register 
preservation requirements that are discussed in Section 4.6.1. 
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The name c_intoo is reserved for the system reset interrupt. This special 
interrupt routine initializes the system and calls the function main; c_intoo 
does not save any registers because it has no caller. 

If a C interrupt routine does not call any other functions, only those registers 
that are actually used in the interrupt handler are saved and restored. How¬ 
ever, if a C interrupt routine does call other functions, these functions may 
modify unknown registers that are not used in the interrupt handler itself. For 
this reason, the routine saves all the expression registers if any other func¬ 
tions are called. This uses many extra instructions; if you are sure that a 
particular register will not be modified, you can hand-modify the compiled 
code so that an unused register is not saved and restored. 

A C interrupt routine is like any other C function in that it can have local vari¬ 
ables and register variables; however, it should be declared with no 
arguments. Interrupt handling functions should not be called directly. 

4.6.3 Assembly Language Interrupt Routines 

Interrupts can also be handled with assembly language code, as long as the 
register conventions are followed. Like all assembly functions, interrupt rou¬ 
tines can use the stack, access global C variables, and call C functions 
normally. When calling C functions, be sure that all nondedicated registers 
are preserved because the C function can modify any of them. Of course, 
dedicated registers need not be saved because they are preserved by the 
C function. 
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4.7 Expression Analysis 

All C expressions are calculated using the registers designated for expres¬ 
sion analysis: 

□ Registers RO—R3 are used for expression evaluation. 

□ Registers ARO—AR2 are used for indirection with pointers. 

Expressions are evaluated according to standard C precedence rules. 
When a binary operator is analyzed, the order of analysis of the operands 
is based on their relative complexity. The compiler tries to evaluate subex¬ 
pressions in a way that prevents saving temporary results, which are 
calculated in registers, off to memory. This does not apply to those operators 
that specify a particular order of evaluation (such as the comma, &&, and H), 
which are always evaluated in the correct order. 

The compiler attempts to avoid using the address registers in evaluation 
because pipeline delays can result from using auxiliary registers for both 
computation and indirection. This is apparent in the code generated for 
pointer arithmetic, where the arithmetic is evaluated in RO—R3, then moved 
to an auxiliary register when the resulting pointer is actually used. 

Floating-point expressions are evaluated using the on-chip floating-point 
hardware. In general, this means that all floating-point operations are car¬ 
ried out with full extended precision (40 bits). However, in some cases an 
extended-precision temporary result in a register must be saved off to 
memory, in which case only 32 bits of precision are preserved. 
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4.8 Runtime-Support Math Routines 

The TMS320C30 MPYI (multiply integer) instruction does not perform full 
32-bit multiplication; it uses only the lower 24 bits of each operand. Standard 
C requires full 32-bit multiplication. Therefore, a runtime-support function 
called MPYJ is provided to implement 32-bit integer multiplication. This 
function does notfollowthe standard C calling sequence; instead, operands 
are passed in registers RO and R1. The 32-bit product is returned in RO. The 
compiler uses the TMS320C30 MPYI instruction only in cases where ad¬ 
dress arithmetic is performed (such as during array indexing); because no 
address can have more than 24 bits, a 24x24 multiply is sufficient. You can 
use the-mm option to force the compilerto use MPYI instructions for all inte¬ 
ger multiplies. 

Because the TMS320C30 has no division instructions, integer and 
floating-point division are performed via calls to additional runtime-support 
functions called DIVJ and DIV_F. Another function called MODJ performs 
the integer modulo operation. Corresponding functions called DIV_U and 
MOD_U are used for unsigned integer division and modulo. Like MPYJ, 
these functions take their arguments from RO and R1 and return the result 
in RO. 

The runtime-support math functions can use volatile registers RO—R3 and 
the index registers IRO and IR1 without saving them. Any other registers that 
are used must be saved. The versions of the functions supplied with the 
compiler use no additional registers. 

The runtime-support math functions are written in assembly language. 
Object code for them is provided in the object library rts. lib. Any of these 
functions that your program needs are linked in automatically if you name 
rts. lib as input at link time. 

The source code for these functions is in the source library rts. src. The 
source code has comments that describe the operation and timing of the 
functions. You can extract, inspect, and modify any of the math functions; 
be sure you follow the special calling conventions and register saving rules 
outlined in this section. 
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Figure 4-5 summarizes the runtime-support math functions and names the 
fiies that contain the functions. 

Figure 4-5. Summary of Runtime-Support Math Functions 


Function 

Description 

Source File 

DIV^F 

Floating-point divide 

divf.asm 

DIVJ 

Integer divide 

divi.asm 

DIV_U 

Unsigned integer divide 

divu.asm 

MOD_l 

Integer modulo 

modi.asm 

MOD_U 

Unsigned integer modulo 

modu.asm 

MPY_I 

32x32 Integer multiply 

mpyi.asm 
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4.9 Optimization 

The TMS320C30 C compiler was designed with two major goals in mind: 

□i For general purpose C code, the TMS320C30 C compiler produces 
compiled code that performs nearly as well as hand-coded assembly 
language. 

□ For critical DSP algorithms, the TMS320C30 C compiler provides a sim¬ 
ple and accessible programming environment so that applications de¬ 
manding high performance can be implemented in assembly language. 

The compiler performs a wide variety of optimizations to improve the 
efficiency of compiled code. The degree of optimization relative to hand- 
coded assembly language for a given program is exTr-eme/y dependent on 
how the program is written; if the code is written specifically with the C30 
compiler in mind, the generated code can be nearly as efficient as assembly 
language. 

The following list describes some of the optimizations and highlights 
particular strengths of the compiler; 

□ Register Variables 

By using register variables, the compiler generates excellent code for 
expressions involving these variables. Register variables are particu¬ 
larly valuable as pointers. 

Q Register Tracking 

The compiler tracks the contents of registers so it avoids reloading val¬ 
ues if they are used again soon. Variables, constants, and structure ref¬ 
erences (a.b) are tracked through straight-line code and forward 
branches. 

□ 3-Operand Instructions 

By using 3-operand instructions whenever possible, the compiler 
preserves the contents of the registers and allows more flexibility in ad¬ 
dressing. These instructions are particularly effective in conjunction 
with register variables. 

□ Algebraic Reordering 

The compiler reorders expressions into algebraic equivalents to allow 
optimal evaluation. For example: -(a + b), which takes 3 instructions to 
evaluate, is written as -a -b, which only takes 2 instructions. 
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□ Jump Optimizations 

The compiler unwinds jumps to jumps and eliminates dead code 
(unlabeled code following an unconditional jump). 

□ Loop Rotation 

The compiler evaluates loop conditionals at the top and bottom of 
loops, saving a costly extra jump into or out of a loop. In cases of simple 
counting loops (for(i= 0;i< 10;...) jthe initial entry conditional check is 
optimized out. 

□ Delayed Branches 

Where possible, the compiler uses delayed branches for unconditional 
branches, avoiding pipeline delays caused by standard branches. 

□ Parailei Instructions 

Because of the restrictive addressing requirements of the parallel in¬ 
structions, it is difficult for the compiler to take advantage of them. How¬ 
ever, in cases where two adjacent instructions fit the addressing re¬ 
quirements, they are combined in parallel instructions. Also, the 
compiler uses parallel instructions for structure move operations. 

□ Autoincrement Addressing 

For pointer expressions of the form *p++, *p — , *++p,or * —p, the com¬ 
piler uses efficient autoincrement addressing modes. 

I-1 

Note: 

If you use the -g option to generate symbolic debugging information, many 
of these optimizations are disabled because they disrupt the debugger. If 
you want to use symbolic debugging and still generate fully optimized code, 
use the -mn option on CL30; -mn re-enables the optimizations disabled 
by-«. 
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4.10 System Initialization 

Before you can run a C program, the C runtime environment must be 
created. This task is performed by the C boot routine, which is a function 
called cJntOO. The runtime-support source library contains the source to 
this routine in a module named boot .asm. 

The cJntOO function can be called by reset hardware to begin running the 
system. The function is in the runtime support library (rts.iib) and must 
be combined with the C object modules at link time. This occurs by default 
when you use the -c or-cr option in the linker and include rts. lib as one 
of the linker input files. When C programs are linked, the linker sets the entry 
point value in the executable output module to the symbol c_intoo. 

The cJntOO function performs the following tasks in order to initialize the C 
environment: 

1) Defines a section called .stack for the system stack and sets up the ini¬ 
tial stack and frame pointers. 

2) Autoinitializes global variables by copying the data from the initialization 
tables in .cinit to the storage allocated for the variables in .bss. In the 
small model, the constant tables are also copied from .cinit to .bss. 

In the RAM initialization model, a loader performs this step before the 
program runs (it is not performed by the boot routine). 

3) Small memory model only—sels up the page pointer DP to point to the 
global storage page in .bss. 

4) Calls the function main to begin running the C program. 

You can replace or modify the boot routine to meet your system require¬ 
ments. However, the boot routine must perform the four operations listed 
above in order to correctly initialize the C environment. 

4.10.1 Autoinitialization of Variables and Constants 

Some global variables must have initial values assigned to them before a 
C program starts running. The process of retrieving these variables’ data 
and initializing the variables with the data is called autoinitialization. 

The compiler builds tables in a special section called .cinit that contains 
data for initializing global and static variables. Each compiled module con¬ 
tains these initialization tables. The linker combines them into a single table 
(a single .cinit section). The boot routine uses this table to initialize all the 
variables that need values before the program starts running. 


4-30 


Runtime Environment 




System Initialization 


j-1 

Note: 

In standard C, global and static variables that are not explicitly initialized are 
set to 0 before program execution. The TMS320C30 C compiler does not 
adhere to this convention. Any variable which must have an initial value of 
0 must be explicitly initialized. 

I_I 


In the small memory model, any tables of long constant values or constant 
addresses must also be copied into the global data page at this time. Data 
for these tables is incorporated into the initialization tables in .cinit and thus 
is automatically copied at initialization time. 

There are two methods for copying the autoinitialization data into memory; 
these methods are called the RAM and ROM models of autoinitialization. 
Section 4.10.1.1 describes the format of the initialization tables, Section 
4.10.1.2 describes the RAM model of initialization, and Section 4.10.1.3 de¬ 
scribes the ROM model of initialization. 

4.10.1.1 Initialization Tables 

The tables in .cinit consist of variable size initialization records. Figure 4-6 
shows the format of the .cinit section and the initialization records. 

Figure 4-6. Format of Initialization Records in the .cinit Section 

.cinit Section 



□ The first field of an initialization record is the size (in words) of the initiai- 
ization data. 

□ The second field is the starting address of the area within the .bss sec¬ 
tion, where the initialization data must be copied. (This field points to a 
variable’s space in .bss.) 

□ These first two fields are followed by one or more words of data. During 
autoinitialization, this data is copied to the specified address in .bss. 
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Each variable that must be autoinitialized has an initialization record 
in the .cinit section. 

For example, suppose two initialized variables are defined in C as follows: 

int i = 23; 

int a[5] = { 1, 2, 3, 4, 5 }; 

The initialization information for these variables is: 


■k 


. sect 

Record for 
.word 
.word 
.word 


".cinit" 
variable i 
1 

_i 

23 


Initialization section 

Length of data (1 word) 

Address in .bss 

Data 


* Record for variable a 
.word 5 

.word _a 

.word 1,2,3,4,5 


Length of data (5 words) 

Address in .bss 

Data 


The .cinit must contain only initialization tables in this form. If you interface 
assembly language modules to your C program, do not use the .cinit section 
for any other purpose. 


When you use the -c or -cr linker option, the linker links together the .cinit 
sections from all the C modules and appends a null word to the end of the 
composite .cinit section. This terminating record appears as a record with 
a size field of 0, marking the end of the initialization tables. 


4.10.1.2 RAM Initialization Model 


The RAM model, specified with the -cr linker option, allows variables to be 
initialized at load time instead of at run time. This enhances system perform¬ 
ance by reducing boot time and by saving the memory that would ordinarily 
be used by the initialization tables. 

When you use the -cr linker option, the linker sets the STYP_COPY bit in 
the .cinit section’s header; this tells the loader notlo load the .cinit section 
into memory. (The .cinit section occupies no space in the memory map.) 
The linker also sets the cinit section to -1 (normally, cinit would point 
to the beginning of the initialization tables). This indicates to the boot routine 
that the initialization tables are not present in memory; accordingly, no run¬ 
time initialization is performed at boot time. 

Note that you must use a smart loader to take advantage of the RAM model. 
When the program is loaded, the loader must be able to: 

□ Detect the presence of the .cinit section in the object file. 

□ Find out that STYP_COPY is set in the .cinit section header, so that it 
knows not to copy the .cinit section into memory. 

□ Understand the format of the initialization tables. 


4-32 


Runtime Environment 




System Initialization 


The loader then uses the initialization tables directly from the object file to 
initialize variables in .bss. 

Figure 4-7 illustrates the RAM model of autoinitialization. 

Figure 4-7. RAM Model of Autoinitialization 

Object Fite Memory 



4 . 10.1.3 ROM Initialization Model 

The ROM model is the default method of the autoinitialization; to use this 
model, invoke the linker with the -c option. 

In this method, global variables are initialized at run time. The .cinit section 
is loaded into memory (possibly ROM) along with all the other sections. The 
linker defines a special symbol called cinit that points to the beginning of 
the initialization tables in memory. When the program begins running, the 
C boot routine copies data from the tables (pointed to by cinit) into the spe¬ 
cified variables in .bss. This allows initialization data to be stored in ROM 
and then copied to RAM each time the program is started. 
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Figure 4-8 illustrates the ROM model of autoinitialization. 

Figure 4-8. ROM Model of Autoinitialization 

Object File Memory 
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Chapter 5 


Runtime-Support Functions 


Some of the tasks that a C program must perform (such as floating-point 
arithmetic, string operations, and dynamic memory allocation) are not part 
of the C language. The runtime-support functions, which are included with 
the C compiler, are standard functions that perform these tasks. The 
runtime-support library rts.iib contains the object code for each of the 
functions described in this chapter; the library rts. src contains the source 
to these functions as well as to other functions and routines. If you use any 
of the runtime-support functions, be sure to include rts. lib as linker input 
when you link your C program. 

This chapter is divided into three parts: 

□ Part 1 describes header files and discusses their functions. 

□ Part 2 summarizes the runtime-support functions according to 
category. 

□ Part 3 is an alphabetical reference. 

Topics in this chapter include: 


Section Page 

5.1 Header Files .5-2 

5.2 Summary of Runtime-Support Functions and Macros.5-9 

5.3 Functions Reference.5-16 
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5.1 Header Files 

Each runtime-support function is declared in a header file. Each header tile 
declares; 

□ A set of related functions (or macros), 

□ Any types that you need to use the functions, and 

□ Any macros that you need to use the functions. 

There are header files that declare the runtime-support functions: 

assert.h limits.h stddef.h 

ctype.h math.h stdlib.h 

errno.h stdarg.h string.h 

float.h time.h 

In order to use a runtime-support function, you must first use the #inciude 
preprocessor directive to include the header file that declares the function. 
For example, the isdigit function is declared by the ctype. h header. Before 
you can use the isdigit function, you must first include the ctype .h file: 

#include <ctYpe.h> 


val = isdigit(num); 

You can include headers in any order. You must inciude a header before you 
reference any of the functions or objects that it declares. 

Sections 5.1.1 through 5.1.10 describe the header fiies that are included 
with the TMS320C30 C compiler. Section 5.2, page 5-9, iists the functions 
that these headers deciare. 

5.1.1 Diagnostic Messages (assert.h) 

The as sert.h header defines the assert macro, which inserts diagnostic 
failure messages into programs at runtime. The assert macro tests a 
runtime expression. If the expression is true, the program continues 
running. If the expression is faise, the macro outputs a message that 
contains the expression, the source file name, and the line number of the 
statement that contains the expression; then, the program terminates (via 
the abort function). 

The assert. h header refers to another macro named NDEBUG (assert. h 
does not define NDEBUG). If you have defined NDEBUG as a macro name 
when you inciude assert .h, then the assert macro is turned off and does 
nothing. If NDEBUG is not defined, then the assert macro is enabied. 
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The assert macro is defined as follows: 

#ifdef NDEBUG 
#define assert(ignore) 

#else 

#define assert(expr) \ 

if (!(expr)) {printf("Assertion failed,(expr), file s,\ 

line d\n",_^FILE_,_LINE_)/ abort (); } 

#endif 

5.1.2 Character Typing and Conversion (ctype. h) 

The ctype.h header declares functions that test (type) and convert 
characters. 

For example, a character-typing function may test a character to determine 
whether it is a letter, a printing character, a hexadecimal digit, etc. These 
functions return a value of true (a nonzero value) or false (0). 

The character-conversion functions convert characters to lowercase, upper 
case, or ASCII and return the converted character. 

Character-typing functions have names in the form isxxx (for example, 
isdigit). Character-conversion functions have names in the form toxxx(for 
example, touppei). 

The ctype.h header also contains macro definitions that perform these 
same operations; the macros run faster than the corresponding functions. 
The typing macros expand to a lookup operation in an array of flags (this 
array is defined in ctype.c ). The macros have the same name as the 
corresponding functions, but each macro is prefixed with an underscore (for 
example, Jsdigif). 

5.1.3 Limits (float.h and iimits.h) 

The float .h and Iimits.h headers define macros that expand to useful 
limits and parameters of the TMS320C30’s numeric representations. 
Table 5-1 and Table 5-2 list these macros and the limits they are 
associated with. 
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Table 5-1. Macros that Supply Integer Type Range Limits (limits .h) 


Macro 

Value 

Description 

CHAR_BIT 

32 

Number of bits in type char 

SCHAR_MIN 

-2147483648 

Minimum value for a signed char 

SCHAR_MAX 

2147483647 

Maximum value for a signed char 

UCHAR_MAX 

4294967295 

Maximum value for an unsigned char 

CHAR_MIN 

SCHAR_MIN 

Minimum value for a char 

CHAR_MAX 

SCHAR_MAX 

Maximum value for a char 

SHRT_MIN 

-2147483648 

Minimum value for a short int 

SHRT_MAX 

2147483647 

Maximum value for a short int 

USHRT_MAX 

4294967295 

Maximum value for an unsigned short int 

INT_MIN 

-2147483648 

Minimum value for an int 

INT_MAX 

2147483647 

Maximum value for an int 

UINT_MAX 

4294967295 

Maximum value for an unsigned int 

LONG_MIN 

-2147483648 

Minimum value for a long int 

LONG_MAX 

2147483647 

Maximum value for a long int 

ULONG_MAX 

4294967295 

Maximum value for an unsigned long int 
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Table 5-2. Macros that Supply Floating-Point Range Limits ('float .h^ 


Macro 

Value 

Description 

FLT_RADIX 

2 

Base or radix of exponent representation 

FLT_ROUNDS 

1 

Rounding mode for floating-point addition 
(rounds to nearest integer) 

FIT DIG 

DBL DIG 

LDBL_DIG 

6 

Number of decimal digits of precision for a float, 
double, or long double 

FIT MANT DIG 

DBL MANT DIG 
LDBL__MANT_D!G 

24 

Number of base-FLT_RADIX digits in the 
mantissa of a float, double, or long double 

FLT MIN EXP 

DBL MIN EXP 
LDBL_MIN_EXP 

-126 

Minimum negative Integer such that FLT_RADIX 
raised to that power minus 1 is a normalized 
float, double, or long double 

FLT MAX EXP I 

DBL MAX EXP i 
LDBL_MAX_EXP 

128 

Maximum negative integer such that FLT_RADIX 
raised to that power minus 1 is a representive 
finite float, double, or long double 

FLT EPSILON 

DBL EPSILON 
LDBL_EPSILON 

1.1920929E-07 

1 

Minimum positive float, double, or long double 
number X such that 1.0+ x^l.O 

FLT MIN 

DBL MIN 

LDBL_MIN 

5.8774817E-39 

Minimum positive float, double, or long double 

FLT MAX 

DBL MAX 

LDBL_MAX 

3.4028235E+38 

Maximum positive float, double, or long double 

FLT MIN 10 EXP 
DBL MIN 10 EXP 
LDBL_MIN_10_EXP 

-39 

Minimum negative integers such that 10 raised to 
that power is in the range of normalized floats, 
doubles, or long doubles 

FLT MAX 10 EXP 
DBL MAX 10 EXP 
LDBL MAX 10 EXP 

38 

Maximum positive integers such that 10 raised to 
that power is in the range of finite floats, doubles, 
or long doubles 


Key to prefixes: 

FLT_ applies to type float 
DBL__ applies to type double 
LDBL_ applies to type long double 

5.1.4 Floating-Point Math (math. h) 

The math.ii header defines several triQonometric, exponential, and 
hyperbolic math functions. These math functions expect double-precision 
floating-point arguments and return double-precision floating-point values. 

The math.h header also defines one macro named HUGE_VAL; the math 
functions use this macro to represent out-or-range values. When a function 
produces a floating-point return value that is too large to be represented, it 
returns HUGE VAL instead. 
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5.1.5 Error Reporting (errno.h) 

Errors can occur in a math function if the invalid parameter values are 
passed to the function or if the function returns a result that is outside the 
defined range for the type of the result. When this happens, a variable 
named ermo is set to the value of one of the following macros: 

□ EDOM, for domain errors (invalid parameter), or 

□ ERANGE, for range errors (invalid result). 

C code that calls a math function can read the value of ermo to check for 
error conditions. The ermo variable is declared in ermo. h and defined in 

errno. c. 

5.1.6 Variable Arguments (stdarg . h) 

Some functions can have a variable number of arguments whose types can 
differ; such a function is called a variable-argument function. The stdarg. h 
header declares three macros and a type that help you to use variable- 
argument functions: 

□ The three macros are va_start, va_arg, and va_end. These macros are 
used when the number and type of arguments may vary each time a 
function is called. 

□ The type, vajist, is a pointer type that can hold information for va_start, 
va_end, and va_arg. 

A variable-argument function can use the objects declared by stdarg. h to 
step through its argument list at run time, when it knows the number and 
types of arguments actually passed to it. 

5.1.7 Standard Definitions (stddef . h) 

The St dde f. h header defines two types and two macros. The types include: 

□ ptrdiffjt, a signed integer type that is the data type resulting from the 
subtraction of two pointers; and 

□ sizejt, an unsigned integer type that is the data type of the sizeof 
operator. 

The macros include: 

□ The NULL macro, which expands to a null pointer constant(O), and 

□ The offsetof(type, identifier) macro, which expands to an integer that 
has type size_t. The result is the value of an offset in bytes to a structure 
member (identifier) from the beginning of its structure (type). 

These types and macros are used by several of the runtime-support 
functions. 
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5.1.8 General Utilities (stdiib. h) 

The stdiib.h header declares several functions, one macro, and two 

types. The macro is named RAND_MAX. The types include: 

□ div_t, a structure type that is the type of the value returned by the div 
function, and 

□ ldiv_t, a structure type that is the type of the value returned by the Idiv 
function. 

The stdiib. h header also declares many of the common library functions; 

□ Memory management functions that allow you to allocate and 
deallocate packets of memory. The amount of memory that these 

functions can use is defined by the constant_ sysmem size in the 

runtime-support module sysmem.asm. (This module is archived in the 
file rt s. src.) By default, the amount of memory available for allocation 
is 2048 words. You can change this amount by modifying 
_ sYSMEM_sizE and reassembling sysmem.asm. 

□ String conversion functions that convert strings to numeric 
representations. 

□ Searching and sorting functions that allow you to search and sort 
arrays. 

□ Sequence-generation functions that allow you to generate a pseudo¬ 
random sequence and allow you to choose a starting point for a 
sequence. 

□ Program-exit functions that allow your program to terminate normally 
or abnormally. 

□ Integer-arithmetic that is not provided as a standard part of the C 
language. 

5.1.9 String Functions (string. h) 

The St ring. h header declares standard functions that allow you to perform 

the following tasks with character arrays (strings): 

□ Move or copy entire strings or portions of strings, 

□ Concatenate strings, 

□ Compare strings, 

□i Search strings for characters or other strings, and 

□ Find the length of a string. 

In C, all character strings are terminated with a 0 (null) character. The string 

functions named strxxxall operate according to this convention. Additional 
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functions that are also declared in string.h allow you to perform 
corresponding operations on arbitrary sequences of bytes (data objects), 
where a 0 value does not terminate the object. These functions have names 
such as memxxx. 

When you use functions that move or copy strings, be sure that the 
destination is large enough to contain the result. 

5.1.10 Time Functions (time. h) 

The time. h header declares one macro, several types, and functions that 
manipulate dates and time. The functions deal with several types of time: 

□ Calendar time represents the current date (according to the Gregorian 
calendar) and time. 

□ Local time is the calendar time expressed for a specific time zone. 

□ Daylight savings time is a variation of local time. 

The time.h header declares one macro, CLK_TCK, which is the number 
per second of the value returned by the clock function. 

The header declares three types: 

□ clock_t, an arithmetic type that represents time; 

□ time_t, an arithmetic type that represents time, and 

□ tm is a structure that holds the components of calendar time, called 
broken-down time. The structure has the following members: 


int 

tm sec; 

/* 

seconds after the minute (0—59) 


int 

tm min; 

/* 

minutes after the hour (0—59) 

■k/ 

int 

tm hour; 

/* 

hours after midnight (0—23) 

k/ 

int 

tm_mday; 

/* 

day of the month (1—31) 

k/ 

int 

tm mon; 

/* 

months since January (0—11) 

k/ 

int 

tm_year; 


years since 1900 (0—99) 


int 

tm wday; 


days since Saturday (0—6) 


int 

tm yday; 

/* 

days since January 1 (0—36^ 

k/ 

int 

tm_isdst; 


Daylight Savings Time f^/ag — 

k/ 


tm_isdst can have one of three values: 

■ A positive value if Daylight Savings Time is in effect. 

■ Zero if Daylight Savings Time is not in effect. 

■ A negative value if the information is not available. 

I-1 

Note: 

All of the time functions depend on the clock() and time() functions, which 
you must customize for your system. 

I_I 
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5.2 Summary of Runtime-Support Functions and Macros 

Refer to the following pages for information about functions and macros; 


Function or Macro Page 

Error Message Macro. 5-10 

Character Typing Conversion Functions . 5-10 

Floating-Point Math Functions. 5-11 

Variable Argument Functions and Macros. 5-12 

General Utilities . 5-12 

String Functions. 5-14 

Time Functions. 5-15 
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Error Message Macro 

(Header File: assert .h) 

Macro and Syntax 

Description 


void assert (expression) 
int expression; 


Inserts diagnostic messages into programs 


Character Typing Conversion Functions 

(Header File: ctype .h) 


Function and Syntax Description 


int isalniim (c) 

char c: 

Tests c to see if it’s an alphanumeric-ASCII 
character 

int isalpha (c) 

char c: 

Tests c to see if it’s an alphabetic-ASCll character 

int isascii (c) 

char c: 

Tests c to see if it’s an ASCII character 

int iscntrl (c) 

char c: 

Tests c to see if it’s a control character 

int isdigit(c) 

char c: 

Tests c to see if it’s a numeric character 

int isgraph ( c ) 

char c: 

Tests c to see if it’s any printing character except a 
space 

int islower (c) 

char c: 

Tests c to see if it’s a lowercase alphabetic ASCII 
character 

int isprint (c) 

char c: 

Tests c to see if It’s a printable ASCII character 
(Including spaces) 

int ispunct (c) 

char c: 

Tests c to see If it’s an ASCII punctuation character 

int isspace (c) 

char c: 

Tests c to see if it’s an ASCII spacebar, tab 
(horizontal or vertical), carriage return, formfeed, or 
newline characters 

int i supper (c) 

char c: 

Tests c to see if it’s an uppercase ASCII alphabetic 
character 

int isxdigit (c) 

char c: 

Tests c to see if it’s a hexadecimal digit 

char toascii (c) 
char c: 

Masks c into a legal ASCII value 

char tolower (c) 

char c: 

Converts c to lowercase if it’s uppercase 

char toupper (c) 

char c; 

Converts c to uppercase if it’s lowercase 
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Floating-Point Math Functions 

(HeaderFile: math.h) 


Function and Syntax Description 


double acos (x) 

double x; 

Returns the arc cosine of x 

double asin (x) 

double x; 

Returns the arc sine of x 

double atan (x) 

double x; 

Returns the arc tangent of x 

double atan2 (y,x) 

double y,x; 

Returns the inverse tangent of y/x 

double ceil (x) 

double x; 

Returns the smallest integer greater than or equal 
to X 

double cos (x) 

double x; 

Returns the cosine of x 

double cosh (x) 

double x; 

Returns the hyperbolic cosine of x 

double exp (x) 

double x; 

Returns the exponential function of x 

double fabs (x) 

double x; 

Returns the absolute value of x 

double floor (x) 

double x; 

Returns the largest integer less than or equal to x 

double fmod (x, y) 

double X, y; 

Returns the floating-point remainder of x/y 

double frexp (value,exp) 
double value; 
int *exp; 

Breaks value into a normalized fraction and an 
integer power of 2 

double Idexp (x, exp) 

double x; 
int exp; 

Multiplies X by an integer power of 2 

double log (x) 

double x; 

Returns the natural logarithm of x 

double loglO (x) 

double x; 

Returns the base-10 logarithm of x 

double modf (value, iptr) 
double value; 
int *iptr; 

Breaks value into into a signed integer and a 
signed fraction 

double pow (x, y) 

double X, y; 

Returns x raised to the power y 

double sin (x) 

double x; 

Returns the sine of x 

double sinh (x) 

double x; 

Returns the hyperbolic sine of x 
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(continued) 



Function and Syntax 

Description 

double 

sqrt (x) 

Returns the nonnegative square root of x 

double 

x; 


double 

tcUl (x) 

Returns the tangent of x 

double 

x; 


double 

tanh (x) 

Returns the hyperbolic tangent of x 

double 

x; 


Variable Argument Functions and Macros 

(Header File: stdarg.h) 


Function/Macro and Syntax 

Description 

type va___arg (ap, type) 
va list ap; 

Accesses the next argument of type type in a 
variable-argument list 

void va__end ( ap ) 

va list ap; 

Resets the calling mechanism after using va_arg 

void va_start(ap, parmN) 
va list ap; 

Initializes ap to point to the first operand in the 
variable-argument list 

General Utilities 

(Header File: stdlib.h) 

Function and Syntax 

Description 

int abs ( j ) 

int j ; 

Returns the absolute value of j 

void abort () 

Terminates a program abnormally 

void atexit (fun) 

void (*fun)(); 

Registers the function pointed to by fun, to be 
called with out arguments at normal program 
termination 

double atof (nptr) 

char *nptr; 

Converts a string to a floating-point value 

int atoi (nptr) 

char ’^nptr; 

Converts astring to an Integer value 

long int atol (nptr) 
char *nptr; 

Converts astring to a long integer 


void *bsearch (key, base, nmemb, size, compar) 


void 

*key, *base; 

Searches through an array of nmemb objects for 

size_t 

nmemb, size; 

the object that key points to 

int 

(*compar)(); 


void*calloc (nmemb, size) 

Allocates and clears memory for nmemb objects, 

size_t 

nmemb, size | 

each of size bytes 
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General Utilities 

(continued) 


Function and Syntax 

Description 

div_t div (numer, denom) 
int numer, denom 

Divides numer by denom 

void exit (status) 

int status; 

Terminates a program normally 

void free (ptr) 

void *ptr; 

Deallocates memory space allocated by malioc, 
calloc, or realloc 

long int labs (j) 

long int j; 

Returns the absolute value of j 

ldiv_t Idiv (numer, denom) 
long int numer, denom 

Divides numer by denom 

int Itoa (n, buffer) 

long n; 
char ^buffer; 

Converts n to the equivalent string 

void *malloc (size) 
size_t size 

Allocates memory for an object of size bytes 

void minit() 

Resets all the memory previously allocated by 

malioc, calloc, or realloc 

char *movmem (src, dest, count) 

char *src, *dest; 
int count; 

Moves count bytes from src to dest 

void qsort (base, nmemb, size, compar) 
void *base; 

size t nmemb, size; 
int (*compar) () ; 

Sorts an array of nmemb members; base points 
to the first member of the unsorted array, and 
size specifies the size of each member 

int rand () 

Returns a sequence of pseudo-random integers In 
the range 0 to RAND_MAX 

void^realloc (ptr, size) 
void *ptr; 

size_t size; 

Changes the size of an allocated memory space 

void srand (seed) 

unsigned int seed; 

Resets the random number generator 

double strtod (nptr, endptr) 
char *nptr, **endptr; 

Converts a string to a floating-point value 

long int strtol (nptr, endptr, base) 
char *nptr,**endptr; 
int base; 

Converts a string to a long integer 

unsigned long int strtoul 
char *nptr, **endptr; 
int base; 

Converts a string to an unsigned long integer 
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String Functions 

(HeaderFile: string.h) 


Function and Syntax Description 


void *memchr(s, c, n) 
void *s; 
int c ; 

size_t n; 

Finds the first occurrence of c in the first n charac¬ 
ters of s 

int memcmp (si, s2, n) 

void *sl, *s2; 

size_t n; 

Compares the first n characters of si to s 2 

void *memcpy (si, s2, n) 

void *sl, *s2; 

size_t n; 

Copies n characters from si to s2 

void *meinnvove (si, s2, n) 

void *sl, *s2; 

size_t n; 

Moves n characters from s i to s2 

void *memset (s, c, n) 
void *s; 
int c; 

size_t n; 

Copies the value of c into the first n characters of s 

char *strcat (si, s2) 

char *sl, *s2; 

Appends si to the end of s2 

char *strchr (s, c) 

char *s; 
int c; 

Finds the first occurrence of character c in s 

int strcmp (si, s2) 

char *sl, *s2; 
is greater than s2 

Compares strings and returns one of the following 
values: <0 If si is less than s2; =0 if si is equal 
to s2; >0 if si is greater than s2 

int ' *strcoll (si, s2) 
char *sl, *s2; 

Compares strings and returns one of the following 
values, depending on the locale: <0 if si Is less 
than s2; =0 if si is equal to s2; >0 if si is greater 
than s2 

char *strcpy (si, s2) 

char *sl, *s2; 

Copies string s2 into si 

size_t strcspn (si, s2) 
char *sl, *sl; 

Returns the length of the initial segment of si that 
is made up entirely of characters that are not in s2 

char *strerror (errnum) 
int ermum; 

Maps the error number in errnum to an error 
message string 

size_t strlen (s) 

char *s; 

Returns the length of a string 

char *strncat (si, s2, n) 
char *sl, *s2; 

size_t n; 

Appends up to n characters from si to s2 

int *strncmp (si, s2, n) 
char *sl, ’^s2; 

size t n; 

Compares up to n characters in two strings 
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String Functions 

(continued) 


Function and Syntax Description 

char *strncpy (si, s2, n) 
char *sl, *s2; 

size_t n; 

Copies up to n characters of a s2 to si 

char *strpbrk (si, s2) 

char *sl, *s2/ 

Locates the first occurrence in si of any character 
from s2 

char *strrchr (s ,c) 

char *s; 
int c; 

Finds the last occurrence of character c in s 

size_t strspn (si, s2) 

char *sl, *s2; 

Returns the length of the initial segment of si, 
which is entirely made up of characters from s2 

char *strstr (si, s2) 

char *sl, *s2/ 

Finds the first occurrence of a s2 to si 

char *strtok (si, s2) 

char *sl, *s2; 

Breaks si into a series of tokens, each delimited 
by a character from s2 


Time Functions 

(Header File: time. h) 


Function and Syntax 

Description 

char *asctime (timeptr) 
struct tm *timeptr; 

Converts a time to a string 

clock_t clock 0 

Determines the processor time used 

char *ctime (timeptr) 

struct tm ^timeptr; 

Converts calendar time to local time 

double difftime (timel,timeO) 
time t timel, timO; 

Returns the difference between two calendar times 

struct tm ^gmtime (timer) 
time_t *timer; 

Converts calendar time to Greenwich Mean Time 

struct tm * localtime (timer) 
time_t *timer; 

Converts calendar time to local time 

time_t mktirae (timeptr) 
struct tm *timeptr; 

Converts local time to calendar time 

size_t strftime (s, maxsize, format. 

timeptr) 

char *s, *format; 

size_t maxsize; 
struct tm *timeptr; 

Formats a time into a character string 

time_t time ( time r) 
time_t *timer; 

Returns the current calendar time 
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5.3 Functions Reference 

The remainder of this chapter is a reference. Generally, the functions are 
organized alphabetically, one function per page; however, related functions 
(such as isalpha and isascii) are presented together on one page. Here’s 
an alphabetical table of contents for the functions reference: 

Directive. Page 

abort. 5-18 

abs . 5-19 

acos . 5-20 

asctime. 5-21 

asin. 5-22 

assert . 5-23 

atan . 5-24 

atan2 .. 5-25 

atexit. 5-26 

atof . 5-27 

atoi . 5-27 

atol . 5-27 

bsearch. 5-28 

calloc .. 5-29 

ceil. 5-30 

clock. 5-31 

cos . 5-32 

cosh . 5-33 

ctime. 5-34 

difftime . 5-35 

div. 5-36 

exit . 5-37 

exp . 5-38 

tabs. 5-39 

floor. 5-40 

fmod . 5-41 

free . 5-42 

frexp . 5-43 

gmtime . 5-44 

isalnum. 5-45 

isalpha . 5-45 

isascii . 5-45 

iscntrl. 5-45 

isdigit . 5-45 

isgraph . 5-45 

islower. 5-45 

isprint . 5-45 

ispunct. 5-45 

isspace . 5-45 

isupper . 5-45 

isxdigit. 5-45 

labs. 5-19 

Idexp. 5-47 
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Idiv. 5-36 

localtime . 5-48 

log. 5-49 

log 10. 5-50 

Itoa . 5-51 

malloc. 5-52 

memchr. 5-53 

memcmp. 5-54 

memcpy . 5-55 

memmove. 5-56 

memset. 5-57 

minit . 5-58 

mktime . 5-59 

modf . 5-60 

movmem. 5-61 

pow. 5-62 

qsort . 5-63 

rand. 5-64 

realloc. 5-65 

sin. 5-66 

sinh. 5-67 

sqrt . 5-68 

srand. 5-64 

strcat. 5-69 

strchr. 5-70 

strcmp. 5-71 

strcoll. 5-71 

strcpy . 5-72 

strcspn . 5-73 

strerror . 5-74 

strftime . 5-75 

strlen. 5-76 

strncat. 5-77 

strncmp. 5-78 

strncpy . 5-78 

strpbrk. 5-80 

strrch. 5-81 

strspn . 5-82 

strstr . 5-83 

strtod. 5-84 

strtok. 5-85 

strtol . 5-84 

strtoul . 5-84 

tan. 5-86 

tanh. 5-87 

time. 5-88 

toascii . 5-89 

tolower . 5-90 

toupper. 5-90 

va_arg. 5-91 

va_end . 5-91 

va start .. 5-91 
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abort Abnormal Termination 


Syntax #include <stdlib.h> 

void abort( ) 

Defined in exit .c in rts.src 

Description The abort function usually terminates a program with an error code. The 
TMS320C30 implementation of the abort function calls the exit function with 
a value of 0, and is defined as follows: 

void abort () 

{ 

exit (0); 

} 

This makes the abort function functionally equivalent to the exit function. 
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Syntax 


Defined in 
Description 


Absolute Value abs/ldbs 


#include <stdlib.h> 

int abs(j) 

int j ; 

long int labs(k) 

long int k; 

abs . c in rts . src 

The C compiler supports two functions that return the absolute value of an 
integer: 

□i The abs function returns the absolute value of an integer, j. 

□ The labs function returns the absolute value of a long integer, k. 

Since /nfand /ong/nfare functionally equivalent types inTMS320C30 C, the 
abs and labs functions are also functionally equivalent. 
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acOS Arc Consine 


SyntBX #include <inath.h> 

doTible acos (x) 

double x; 

Defined in asin.obj in rts.iib 

Description The acos function returns the arc cosine of a floating-point argument; x. x 
must be in the range [-1,1]. The return value is an angle in the range [0,71] 
radians. 

Exampie double realval, radians; 

return (rrealval = 1.0; 

radians = acos(realval); 

return (radians); /* acos return 7C/2 */ 
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Internal Time to String asctime 


Syntax #include <time.h> 

char ^asctime(txmeptr) 

struct tm *timeptr; 

Defined in asctime. c in rts . src 

Description The asctime function converts a broken-down time into a string with the 
foliowing form; 

Mon Jan 11 11:18:36 1988 \n\0 

The function returns a pointer to the converted string. 

For more information about the functions and types that the time. h header 
declares, refer to Section 5.1.10 on page 5-8. 
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asin Arc Sine 


SyntSX #include <math.h> 

doTible asin(x) 

double x; 

Defined in asin. ob j in rts. lib 

Description The asin function returns the arcsine of a floating-point argument; x. x must 
be in the range [-1,1]. The return value is an angle in the range [-71/2,71/2] 
radians. 

Exempie double realval, radians; 

realval = 1.0; 

radians = asin(realval) ; /* asin returns 71/2 */ 
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Syntax 

Defined in 
Description 


Example 


Insert Diagnostic Information Macro assert 


#include <assert.h> 

void assert(expression) 

int expression; 

assert .h as macros 

The assert macro tests an expression; depending on the value of the ex¬ 
pression, assert either aborts execution and issues a message or continues 
execution. This macro is useful for debugging. 

□ If expression is false, the assert macro writes information about the 
particular call that failed to the standard output, and then aborts 
execution. 

□ If expression is true, the assert macro does nothing. 

The header file that declares the assert macro refers to another macro, 
NDEBUG. If you have defined NDEBUG as a macro name when the as¬ 
sert . h header is included in the source file, then the assert macro is defined 
as: 

#define assert(ignore) 

If NDEBUG is not defined when assert. h is included, then the assert macro 
is defined as: 

#define assert(expr) \ 
if (!(expr)) { 

printf("Assertion failed, (expr), file %s, 
line %d\n",_ FILE_LINE_) 

abort 0; } 

In this example, an integer i is divided by another integer j. Since dividing 
by 0 is an illegal operation, the example uses the assert macro to test j be¬ 
fore the division. If j= =0, assert issues a message and aborts the program. 

int i, j; 

assert(j); 
q = i/j; 
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atari Polar Arc Tangent 


Syntax #include <inath.h> 

double atari (x) 

double x; 

Defined in , at an. ob j in rt s. lib 

Description The atari function returns the arc tangent of a floating-point argument, x. 
The return value is an angle in the range [-71/2,71/2] radians. 

Exampie double realval, radians; 

realval = 0.0; 

radians = atan(realval) ; /* return value = 0 */ 
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Cartesian Arc Tangent atan2 


Syntax 

Defined in 
Description 

Exampie 




#include <math.h> 

double atan2(y, x) 

double y, x; 

atari.obj in rtS.lib 

The atan2 function returns the inverse tangent of y/x. The function uses the 
signs of the arguments to determine the quadrant of the return vaiue. Both 
arguments cannot be 0. The return value is an angle in the range [-7t,7C] 
radians. 

double rvalu, rvalv; 
double radians; 

rvalu = 0.0; 
rvalv = 1.0; 

radians = atan2 (rvalr, rvalu); /* return value = 0 '^ / 
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atexit Register Function Cailed by Exit () 


Syntax #include <stdlib.h> 

void atexit(fun) 

void (*fun)(); 

Defined in exit. c in rts. src 

Description The atexit function registers the function that is pointed to by fun, to be 
called without arguments at normal program termination. Up to 32 functions 
can be registered. 

When the program exits through a call to the exit function, the functions that 
were registered are called, without arguments, in reverse order of their 
registration. 
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string to Number atof/atof/atol 


SyntSX finclude <stdlib.h> 

doxible at of (nptr) 

char *nptr; 

int atoi(nptr) 

char *nptr; 

long int atol(nptr) 

char *nptr; 

Defined in atof.cand atoi . c in rts . src 

Description Three functions convert strings to numeric representations: 

□ The atof function converts a string to a fioating-point value. Argument 
nptr points to the string: the string must have the following format: 

[space] [sign] digits [.digits] [eIE [sign] integer] 

□ The atoi function converts a string to an integer. Argument nptr points 
to the string: the string must have the following format: 

[space] [sign] digits 

□ The atoi function converts a string to a long integer. Argument nptr 
points to the string: the string must have the following format: 

[space] [sign] digits 

The space is indicated by a space (character), a horizontal or vertical tab, 
a carriage return, a form feed, or a newline. Following the space is an option¬ 
al sign, and then digits that represent the integer portion of the number. The 
fractional part of the number follows, then the exponent, including an option¬ 
al sign. 

The first character that cannot be part of the number terminates the string. 

Since intend iongare functionally equivalent in TMS320C30 C, the atoi and 
atoi functions are also functionally equivalent. 

The functions do not handle any overflow resulting from the conversion. 
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bsearch Array Search 


Syntax finclude <stdlib.h> 

void *bsearch(key, base, nmemb, size, conpar) 

void *key, *base; 
size_t nmemb, size; 
int (*compar)(); 

Defined in bsearch. c in rts . src 

Description The bsearch function searches through an array of nmemb objects for a 
member that matches the object that key points to. Argument base points 
to the first member in the array; size specifies the size (in bytes) of each 
member. 

The contents of the array must be in ascending, sorted order. If a match is 
found, the function returns a pointer to the matching member of the array; 
if no match is found, the function returns a null pointer (0). 

Argument compar points to a function that compares key to the array 
elements. The comparison function should be declared as: 

int cmp(ptrl, ptr2) 
void ’^ptrl, ’^ptr2; 

The cmp function compares the objects that prti and ptr 2 point to and re¬ 
turns one of the following values: 

< 0 if *ptri is less than *ptr2. 

0 if *ptri is equal to *ptr 2 . 

> 0 if *ptri is greater than *ptr2. 
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Syntax 

Defined in 
Description 


Exampie 


Allocate and Clear Memory callOC 


#include <stdlib.h> 

void *calloc(nmemb, size) 

size_t nmemb; /* number of items to allocate */ 
size_t size; /* size (in bytes) of each item '^/ 

memory. c in rts . src 

The calloc function allocates size bytes for each of nmemb objects and re¬ 
turns a pointer to the space. The function initializes the allocated memory 
to all Os. If it cannot ailocate the memory (that is, if it runs out of memory), 
it returns a null pointer (0). 

The memory that calioc uses is in a special memory pool or heap. An assem¬ 
bly language module called sysmem. asm defines this memory pool as unini¬ 
tialized named section called . sysmem. The constant_ sysmem_size de¬ 

fines the size of the heap as 2048 words. If necessary, you can change the 
size of the heap by changing the value of_ sysmem size and reassem¬ 

bling sysmem. asm. For more information, refer to Section 4.1.4, Dynamic 
Memory Allocation, on page 4-6. 

This example uses the calloc routine to allocate and clear 10 bytes. 

prt = calloc (10,2) ; /^Allocate and clear 20 bytes 
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ceil Ceiling 


Syntax #include <math.h> 

do\ible ceil (x) 

double x; 

Defined in floor. ob j in rts. lib 

Description The ceil function returns a floating-point number that represents the small¬ 
est integer greater than or equal to x. 

Exampie extern double ceil(); 

double answer; 

answer = ceil(3.1415) ; answer = 4.0 */ 

answer = ceil(-3.5); /* answer = -3.0 '^/ 
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Processor Time ClOCk 


Syntax #include <time.h> 

olock_t clock() 

Defined in clock. c in rt s. src 

Description The clock function determines the amount of processor time used. It returns 
an approximation of the processor time used by a program since the pro¬ 
gram began running. The time in seconds is the return value divided by the 
value of the macro CLK_TCK. 

If the processor time is not available or cannot be represented, the clock 
function returns the value of (ciock_t) -1 . 

I-1 

Note: 

The clock function is target-system specific, so you must write your own 
clock function. You must also define the CLK_TCK macro according to the 
granularity of your clock, so that the value returned by clock () (number of 
clock ticks) can be divided by CLK_TCK to produce a value in seconds. 

I_I 


For more information about the functions and types that the time. h header 
declares, refer to Section 5.1.10 on page 5-8. 


5-31 



cos Cosine 


Syntax 

Defined in 
Description 

Exampie 


#include <math.h> 

doiible cos (x) 

double x; 

sin. ob j in rts . lib 

The cos function returns the cosine of a floating-point number, x. x is an 
angle expressed in radians. An argument with a large magnitude may 
produce a result with little or no significance. 

COS returns oval */ 

/* return value = -1.0 */ 


double radians, cval; 
radians = 3.1415927; 

cval = cos(radians); 
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Hyperbolic Cosine COSh 


Syntax #include <math.h> 

dooible cosh(x) 

double x; 

Defined in sinh. ob j in rt s. lib 

Description The cosh function returns the hyperbolic cosine of a floating-point number, 
X. A range error occurs if the magnitude of the argument is too large. 

Exampie double x, y; 

X = 0.0/ 

y = cosh(x); /* return value = 1.0 */ 
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Ctime Calendar Time 


Syntax 

Defined in 
Description 


#include <time.h> 

char *ctime (timer) 

time_t *timer; 

ctime. c in rts . src 

The ctime function converts a calendar time (pointed to by timer) to local 
time, in the form of a string. This is equivalent to: 

asctime(localtime(timer)) 

The function returns the pointer returned by the asctime function with that 
broken-down time as an argument. 

For more information about the functions and types that the t ime. h header 
declares, refer to Section 5.1.10 on page 5-8. 
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Time Difference difftime 


Syntax #include <tiine.h> 

double difftime(timel, timeO) 

time_t timel, timeO; 

Defined in difftime.c in rts.src 

Description The difftime function caiculates the difference between two calendar times, 
timel minus timeO. The return value expresses seconds. 

For more information about the functions and types that the time. h header 
declares, refer to Section 5.1.10 on page 5-8. 
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div/ldiv Division 


Syntax tinclude <stdlib.h> 

diy_jt div(numer, denom) 

int numer, denom; 

ldiy__t ldiv(ntiiner, denom) 

long int numer, denom; 

Defined in div. c in rts. src 

Description Two functions support integer division by returning numer divided by denom. 

You can use these functions to get both the quotient and the remainder in 
a single operation. 

□ The div function performs /nfegerdivision. The input arguments are in¬ 
tegers; the function returns the quotient and the remainder in a structure 
of type div_t. The structure is defined as follows: 

typedef struct 
{ 

int quot; quotient */ 

int rem; /* remainder */ 

} div_t; 

□ The Idiv function performs long /nfeger division. The input arguments 
are long integers; the function returns the quotient and the remainder 
in a structure of type ldiv_t. The structure is defined as follows: 

typedef struct 
{ 

long int quot; /* quotient */ 

long int rem; /* remainder */ 

} ldiv_t; 

If the division produces a remainder, then the sign of the quotient is the same 
as the algebraic quotient, and the magnitude of the resulting quotient is the 
largest integer less than the magnitude of the aigebraic quotient. 

Since ints and longs are equivalent types in TMS320C30 C, these functions 
are also equivalent. 
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Normal Termination exit 


Syntax 

Defined in 
Description 




#include <stdlib.h> 

void exit(status) 

int status; 

exit. c in rts . src 

The exit function terminates a program normally. All functions registered by 
the atexit function are called, in reverse order of their registration. 

You can modify the exit function to perform application-specific shutdown 
tasks. The unmodified function simply runs in an infinite loop until the sys¬ 
tem is reset. 

Note that the exit function cannot return to its caller. 
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exp Exponential 


Syntax 

Defined in 
Description 

Exampie 


#include <math.h> 

doTible exp(x) 

double x; 

exp. ob j in rts . lib 

The exp function returns the exponential function of real number x. The re¬ 
turn value is the number e raised to the power x. A range error occurs if the 
magnitude of x is too large. 

double X, y; 

X = 2.0; 

y = exp(x); /'^ y = 7.38, which is e'^*2.0 */ 
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Absolute Value fabs 

ftSSiS , ^ , , ,, , ^ , , ,' , , •. 


SyntBX #include <math.h> 

doiible fabs (x) 

double x; 

Defined in fabs. ob j in rts. lib 

Description The fabs function returns the absolute value of a floating-point number, x. 


Exempie double x, y; 

X = -57.5; 

y = fabs(x) ; /* return value = +57.5 */ 
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floor Floor 


Syntax finclude <math.h> 

double floor(x) 

double x; 

Defined in floor. ob j in rts. lib 

Description The floor function returns a floating-point number that represents the larg¬ 
est integer less than or equal to x. 

Exampie double answer; 

answer = floor(3.1415) ; /* answer = 3.0 */ 

answer = floor(-3.5); /* answer = -4.0 */ 
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Syntax 

Defined in 
Description 

Example 


Floating-Point Remainder f mod 


#include <math.h> 

doTible fmod(x, y) 

double X, y; 

fmod.obj in rts.lib 

The fmod function returns the floating-point remainder of x divided by y. If 
y= =0, the function returns 0. 

double X, y, r; 

X = 11.0; 
y = 5.0/ 

r = £mod(x^ y) ; /* fmod returns 1.0 '^/ 
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free Deallocate Memory 


Syntax #include <stdlib.h> 

void free(ptr) 

void *ptr; 

Defined in memory. c in rts. src 

Description The free function deallocates memory space (pointed to by ptr) that was 
previously allocated by a malloc, calloc, or realloc call. This makes the 
memory space available again. If you attempt to free unallocated space, the 
function takes no action and returns. For more information, refer to Section 
4.1.4, Dynamic Memory Allocation, on page 4-6. 

Example This example allocates 10 bytes and then frees them. 

/* allocate 10 bytes 
/* free 10 bytes */ 


char *x; 

X = malloc(10) ; 
free(x)/ 
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Fraction and Exponent f rexp 




Syntax #include <math.h> 

double frexp(value, exp) 

double value; /* input floating-point number */ 

int *exp; /* pointer to exponent */ 

Defined in f rexp. ob j in rts. lib 

Description The frexp function breaks a floating-point number into a normalized fraction 
and an integer power of 2. The function returns a value with a magnitude 
in the range ( 1 / 2,1 ) or 0 , so that value = = X X 2(**exp)_ Yh 0 frexp function 
stores the power in the int pointed to by exp. if value is 0 , both parts of the 
result are 0. 

Example double fraction; 

int exp; 

fraction = £rexp(3.0, &exp); 

/* after execution, fraction is .75 and exp is 2 */ 
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gmtime Greenwich Mean Time 


Syntax 

Defined in 
Description 




#include <time.h> 

struct tm ^gmtime (timer) 

time_t ^timer; 

gmt ime. c in rt s . s rc 

The gmtime function converts a calendar time (pointed to by timer) into a 
broken-down time, which is expressed as Greenwich Mean Time. 

For more information about the functions and types that the t ime. h header 
declares, refer to Section 5.1.10 on page 5-8. 
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Character Typing ISXXX 


Syntax #include <ctype.h> 

int isalniim(c) 

char c; 

int isalpha(c) 

char c; 

int isascii(c) 

char c; 

int iscntrl(c) 

char c; 

int isdigit(c) 

char c; 

int isgraph(c) 

char c; 

int islower(c) 

char c; 

int isprint(c) 

char c; 

int ispunct(c) 

char c; 

int isspace(c) 

char c; 

int isupper(c) 

char c; 

int isxdigit(c) 

char c; 

Defined in isxxx. c and ctype. c in rts. src 

Also defined in ctype.h as macros 

Description These functions test a single argument c to see if it is a particular type of 
character—alphabetic, alphanumeric, numeric, ASCII, etc. if the test is true 
(the character is the type of character that it was tested to be), the function 
returns a nonzero value; if the test is false, the function returns 0. The char¬ 
acter typing functions include: 

isalnum identifies alphanumeric ASCII characters (tests for any char¬ 
acter for which isalpha or isdigit is true). 

isalpha identifies alphabetic ASCII characters (tests for any character 

for which islower or isupper is true). 

isascii identifies ASCII characters (any character between 0—127). 

iscntrl identifies control characters (ASCII characters 0—31 and 
127). 

isdigit identifies numeric characters (‘0’— ‘9’) 
isgraph identifies any non-space character. 
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iSXXX Character Typing 


islower identifies iowercase alphabetic ASCII characters. 

isprint identifies printable ASCII characters, including spaces (ASCII 

characters 32—126). 

ispunct identifies ASCII punctuation characters. 

isspace identifies ASCII spacebar, tab (horizontal or vertical), carriage 

return, formfeed, and newline characters. 

isupper identifies uppercase ASCII alphabetic characters. 

isxdigit identifies hexadecimal digits (0—9, a—f, A—F). 

The C compiler also supports a set of macros that perform these same func¬ 
tions. The macros have the same names as the functions, but are prefixed 
with an underscore; for example, Jsascii is the macro equivalent of the 
isascii function. In general, the macros execute more efficiently than the 
functions. 
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Multiply by a Power of Two Idexp 


Syntax #include <math.h> 

double Idexp(x, exp) 

double x; 
int exp; 

Defined in idexp. ob j in rts. lib 

Description The Idexp function multiplies a floating-point number by a power of 2 and 
returns x x exp can be a negative or a positive value. A range error 
may occur if the result is too large. 

Exampie double result; 

result = Idexp(1.5, 5); result is 4 8.0 */ 

result = Idexp(6.0, -3); /* result is 0.75 '^/ 
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localtime Local Time 


Syntax #include <time.h> 

struct tm *localtime(timer) 

t ime_t * t ime r; 

Defined in l oca it ime. c in rts . src 

Description The local time function converts a calendar time (pointed to by timer) into 
a broken-down time, which is expressed as local time. The function returns 
a pointer to the converted time. 

For more information about the functions and types that the time. h header 
declares, refer to Section 5.1.10 on page 5-8. 
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Natural Logarithm log 


Syntax 

Defined in 
Description 

Description 


#include <math.h> 

double log(x) 

double x; 

log.obj in rts.lib 

The log function returns the natural logarithm of a real number, x. A domain 
error occurs if x is negative; a range error occurs if x is 0. 

float X, y; 

X = 2.718282/ 

y = log(x); Return value = 1.0 
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loglO Common Logarithm 


Syntax #include <math.h> 

double loglO(x) 

double x; 

Defined in log. ob j in rts. lib 

Description The Iog10 function returns the base-10 logarithm of a real number, x. A 
domain error occurs if x is negative; a range error occurs if x is 0. 

Exampie float x, y; 

X = 10.0; 

y = log(x); /* Return value = 1.0 / 
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Long Integer to ASCII Itoa 


Syntax #include <stdlib.h> 

int ltoa(n, buffer) 

long n; /* number to convert '^/ 

char "^buffer; /* buffer to put result in 

Defined in itoa.c in rts.src 

Description The Itoa function converts a long integer to the equivalent ASCII string. If 
the input number n is negative, a leading minus sign is output. The Itoa 
function returns the number of characters placed in the buffer. 


5-51 



mallOC Allocate Memory 


Syntax iinclude <stdlib.h> 

void ^malloc(size) 

size_t size; /* size of block in bytes */ 

Defined in memory. c in rts . src 

Description The malloc function allocates space for an object of size bytes and returns 
a pointer to the space. If malloc cannot allocate the packet (that is, if it runs 
out of memory), it returns a null pointer (0). This function does not modify 
the memory it allocates. 

The memory that malloc uses is in a special memory pool or heap. An as¬ 
sembly language module called sysmem. asm defines this memory pool as 

uninitialized named section called . sysmem. The constant_ sys- 

MEM sizE defines the size of the heap as 2048 words. If necessary, you can 

change the size of the heap by changing the value of_ sysmem_si ze and 

reassembling sysmem. asm. For more information, referto Section 4.1.4, Dy¬ 
namic Memory Allocation, on page 4-6. 
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Find First Occurrence of Byte memchr 


Syntax 


Defined in 
Description 


#include <string.h> 

void *memchr(s, c, n) 

void '^s; 
char c; 
siz e_t n; 

memchr. c in rts . src 

The memchr function finds the first occurrence of c in the first n characters 
of the object that s points to. If the character is found, memchr returns a 
pointer to the located character; otherwise, it returns a null pointer (0). 

The memchr function is similar to strchr, except the object that memchr 
searches can contain values of 0, and c can be 0. 
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memcmp Memory Compare 


Syntax #include <string.h> 

int memcmp(si, s2, n) 

void *s2; 

size_t n; 

Defined in memcmp. c in rts . src 

Description The memcmp function compares the first n characters of the object that s2 
points to with the object that si points to. The function returns one of the 
following values: 

< 0 if *si is less than *s2. 

0 if *si is equal to *s2. 

> 0 if *si is greater than *s2. 

The memcmp function is similar to strncmp, except the objects that 
memcmp compares can contain values of 0. 
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Memory Block Copy - Nonoverlapping memcpy 


Syntax #include <string.h> 

void *memcpy(si, s2, n) 

void "^sl, *s2; 
size_t n; 

Defined in memmov. c in rt s . src 

Description The memcpy function copies n characters from the object that s2 points to 
into the object that s i points to. If you attempt to copy characters of overlap¬ 
ping objects, the function’s behavior is undefined. The function returns the 
value of si. 

The memcpy function is similar to strncpy, except the objects that memcpy 
copies can contain values of 0. 
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memmove 

Syntax 

Defined in 
Description 


Memory Block Copy - Overlapping 


#include <string.h> 

void *meinmove(si, s2, n) 

void *sl, *s2; 
siz e_t n / 

memmov. c in rt s . s rc 

The memmove function moves n characters from the object that s2 points 
to into the object that si points to; the function returns the value of si. The 
memmove function correctly copies characters between overlapping 
objects. 
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Duplicate Value in Memory memset 




Syntax #include <string.h> 

void *memset(s, c, n) 

void '^s; 
char c; 
size_t n; 

Defined in memset. c in rts . src 

Description The memset function copies the value of c into the first n characters of the 
object that s points to. The function returns the value of s. 
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minit Reset Dynamic Memory Pool 


Syntax finclude <stdlib.h> 

void minil: () 

Defined in memory. c in rts . src 

Description The minit function resets all the space that was previously allocated by calls 
to the malloc, calloc, or realloc functions. 

I-1 

Note: 

Calling the minit function makes all the memory space in the heap available 
again. Any objects that you allocated previously will be lost; don’t try 
to access them. 

I_I 

The memory that minit uses is in a special memory pool or heap. An assem¬ 
bly language module called sysmem. asm defines this memory pool as unini¬ 
tialized named section called . sysmem. The constant_ sysmem_size de¬ 

fines the size of the heap as 2048 words. If necessary, you can change the 
size of the heap by changing the value of_ sysmem size and reassem¬ 

bling sysmem. asm. For more information, refer to Section 4.1.4, Dynamic 
Memory Allocation, on page 4-6. 
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Syntax 

Defined in 
Description 


Exampie 


Convert to Calender Time mktime 


#include <time.h> 

time t *inktime (timeptr) 

struct tm * timeptr ; 

mktime.c in rts.src 

The mktime function converts a broken-down time, expressed as local time, 
into proper calendar time. The timeptr argument points to a structure that 
holds the broken-down time. 

The function ignores the original values of tm_wday and tm_Yday and does 
not restrict the other values in the structure. After successful completion of 
time conversions, tm_wday and tm_yday are set appropriately, and the other 
components in the structure have values within the restricted ranges. The 
final value of tm_mday is not sent until tm_mon and tm_year are determined. 

The return value is encoded as a value of type time_t. If the calendar time 
cannot be represented, the function returns the value -1. 

This example determines the day of the week that July 4, 2001, falls on. 

#include <time.h> 

static const char *const wday[] = { 

"Sunday", "Monday", "Tuesday", "Wednesday", 
"Thursday", "Friday", "Saturday" }/ 

struct tm time_str; 

time_str.tm_year = 2001 - 1900; 
time_str.tm_mon = 7; 
time_st r.tm_mday = 4; 
time_str.tm_hour = 0; 
time_str.tm_min = 0; 
time_str.tm_sec = 1; 
time_str.tm_isdst = 1/ 

mktime (&time_str) ; 

printf ("result is %s\n", wday[time_str.tm_wday]); 

After calling this function, time_str.tm_wday 
contains the day of the week for July 4, 2001 */ 

For more information about the functions and types that the time. h header 
declares, refer to Section 5.1.10 on page 5-8. 
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modf Signed Integer and Fraction 


Syntax #include <math.h> 

double modf (value, iptr) 

double value; 
int *iptr; 

Defined in modf. ob j in rts. lib 

Description The modf function breaks a value into a signed integer and a signed frac¬ 
tion. Each of the two parts has the same sign as the input argument. The 
function returns the fractional part of value and stores the integer as a 
double at the object pointed to by iptr. 

Exampie double value, ipart, fpart; 

value = -3.1415; 

fpart = modf(value, &ipart); 

/* After execution, ipart contains -3.0, */ 

/'^ and fpart contains -0.1415. */ 
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Syntax 


Defined in 
Description 


Move Memory movmem 


#include <stdlib.h> 

char *movmem(src,desh,count) 


char 

*src ; 

/■k 

source address 


char 

’^dest ; 

/■k 

destination address 


char 

count; 

/* 

number of bytes to move 



movmem. c in rts . src 


The movmem function moves count bytes of memory from the object that 
src points to into the object that dest points to. The source and destination 
areas can be overlapping. 
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POW Raise to a Power 


Syntax #include <math.h> 

double pow(x, y) 

double X, y; /* Raise x to power y */ 

Defined in pow. ob j in rt s. lib 

Description The pow function returns x raised to the power y. A domain error occurs if 
X = 0 and y < 0, or if X is negative and y is not an integer. A range error 
may occur. 

Exampie double x, y, z; 

X = 2.0; 

y = 3.0; 

X = pow(x, y) ; /* return value = 8.0 '^/ 
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Array Sort 


Syntax #include <stdlib.h> 

void qsort (base, nmemb, size, compar) 

void *base; 
size_t nmemb, size; 
int {*compar)(); 

Defined in qsort .c in rts.src 

Description The qsort function sorts an array of nmemb members. Argument base points 
to the first member of the unsorted array; argument size specifies the size 
of each member. 

This function sorts the array in ascending order. 

Argument compar points to a function that compares key to the array 
elements. The comparison function should be declared as: 

int cmp(ptrl, ptr2) 
void "^ptrl, *ptr2; 

The cmp function compares the objects that ptri and ptr 2 point to and re¬ 
turns one of the following values; 

< 0 if *ptri is less than *ptr2. 

0 if *ptri is equal to *ptr2. 

> 0 if *ptri is greater than *ptr2. 
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rand/srand Random integer 


Syntax #inclucle <stdlib.h> 

int rand( ) 

void srand(seed) 

unsigned int seed; 

Defined in rand, c in rts . src 

Description Two functions work together to provide pseudo-random sequence 
generation: 

□ The rand function returns pseudo-random integers in the range 
0-RAND_MAX. 

□ The srand function sets the value of seed so that a subsequent call to 
the rand function produces a new sequence of pseudo-random num¬ 
bers. The srand function does not return a value. 

If you call rand before calling srand. rand generates the same sequence it 
would produce if you first called srand with a seed value of 1. If you call srand 
with the same seed value, rand generates the same sequence of numbers. 
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Change Heap Size reallOC 


Syntax #include <stdlib.h> 

void *realloc(ptr, size) 

void *ptr; /* pointer to object to change */ 

size_t size; /* new size (in bytes) of packet */ 

Defined in memory. c in rts . src 

Description The realloc function changes the size of the allocated memory pointed to 
by ptr, to the size specified in bytes by size. The contents of the memory 
space (up to the lesser of the old and new sizes) is not changed. 

□ If ptr is 0, then realloc behaves like malioc. 

□ If ptr points to unallocated space, the function takes no action and 
returns. 

□ If the space cannot be allocated, the original memory space is not 
changed and realloc returns 0. 

□ If size=0 and ptr is not null, then realloc frees the space that ptr 
points to. 

If, in order to allocate more space, the entire object must be moved, realloc 
returns a pointer to the new space. Any memory freed by this operation is 
deallocated. If an error occurs, the function returns a null pointer (0). 

The memory that realloc uses is in a special memory pool or heap. An as¬ 
sembly language module called sysmem.asm defines this memory pool as 

uninitialized named section called .sysmem. The constant_ sys- 

MEM_sizE defines the size of the heap as 2048 words. If necessary, you can 

change the size of the heap by changing the value of_ s ysmem_s i ze and 

reassembling sysmem.asm. For more information, refer to Section 4.1.4, Dy¬ 
namic Memory Allocation, on page 4-6. 
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sin Sine 


SyntBX finclude <math.h> 

double sin(x) 

double x; 

Defined in s in. ob j in rt s. i ib 

Description The sin function returns the sine of a floating-point number, x. x is an angle 
expressed in radians. An argument with a large magnitude may produce a 
result with little or no significance. 

Exemple double radian, sval; /* sval is returned by sin '^/ 
radian = 3.1415927/ 

sval = sin (radian) ; /* -1 is returned by sin / 
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Hyperbolic Sine sinh 


Syntax #include <math.h> 

double sinh(x) 

double x; 

Defined in sinh. ob j in rts. lib 

Description The sinh function returns the hyperbolic sine of a floating-point number, x. 
A range error occurs if the magnitude of the argument is too large. 

Exampie double x, y; 

X = 0.0/ 

y = sinh(x); /* return value = 0.0 
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sqrt Square Root 


Syntax #include <math.h> 

double sqrt (x) 

double x; 

Defined in sqrt. ob j in rts. lib 

Description The sqrt function returns the nonnegative square root of a real number x. 
A domain error occurs if the argument is negative. 

Exampie double x, y; 

X = 100.0; 

y = sqrt(x) ; /* return value = 10.0 
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Concatenate Strings Strcat 


Syntax # include <string.h> 

char ^strcat(si, s2) 

char *sl, *s2; 

Defined in strcat .c in rts.src 


Description The strcat function appends a copy of s2 (including a terminating null char¬ 
acter) to the end of si. The initial character of s 2 overwrites the null charac¬ 
ter that originally terminated si. The function returns the value of si. 


5-69 



Strchr Find First Occurrence of Character 


Syntax #include <string.h> 

char *strchr{s, c) 

char *s; 
char c; 

Defined in strchr.c in rts.src 

Description The strchr function finds the first occurrence of c in s. If strchrfinds the char¬ 
acter, it returns a pointer to the character; otherwise, it returns a null pointer 
( 0 ). 
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string Compare Strcmp/strcoll 


Syntax finclude <string.h> 

int strcoll{sl, s2) 

char *sl, '^s2; 

int strcanp(sl, s2) 

char *sl, ^s2; 

Defined in strcmp. c in rt s. src 

Description The strcmp and strcoll functions compare s 2 with si. The functions are 
equivalent; both functions are supported to provide compatibility with ANSI 
C. 

The functions return one of the following values: 

< 0 if *si is less than *s2. 

0 if *si is equal to *s2. 

> Oif *si is greater than *s2. 
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Strcpy String Copy 


Syntax #include <string.h> 

char *strcpy(sl, s2) 

char *sl, *s2; 

Defined in strcpy. c in rts.src 


Description The strcpy function copies s2 (including a terminating null character) into 
si. If you attempt to copy strings that overlap, the function’s behavior is 
undefined. The function returns a pointer to si. 
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Find Number of Unmatching Characters Strcspn 


Syntax #include <string.h> 

size^^t strcspn (si, s2) 

char "^sl, *s2; 

Defined in strcspn. c in rts. src 


Description The strcspn function returns the length of the initial segment of si, which 
is entirely made up of characters that are not in s 2 . If the first character in 
si is in s2, the function returns 0. 
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Strerror string Error 


Syntax #include <string.h> 

char *strerror (errnvun) 

int errnum; 

Defined in strerror. c in rts.src 

Description The strerror function returns the string "function error". This function 
is supplied to provide ANSI compatibility. 
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Format Time Strftime 




Syntax #include <time.h> 

size_jt *strftime(s, maxsize, format, timeptr) 

char *s, *format; 
size_t maxsize; 
struct tm *timeptr; 

Defined in strftime . c in rts . src 

Description The strftime function formats a time (pointed to by timeptr) according to 
a format string, and returns the formatted time in the string s. Up to maxsize 
characters can be written to s. The format parameter is a string of charac¬ 
ters that tells the strftime function how to format the time; the foliowing list 
shows the valid characters and describes what each character expands to. 

Character is replaced by... 

%a the abbreviated weekday name (Mon, Tue, ...) 

%A the fuii weekday name 

%b the abbreviated month name (Jan, Feb,...) 

%B the iocaie’s fuii month name 

%c the date and time representation 

%d the day of the month as a decimai number (0—31) 

%H the hour (24-hour clock) as a decimal number (00—23) 

%l the hour (12-hour clock) as a decimal number (01—12) 

%j the day of the year as a decimal number (001—366) 

%m the month as a decimal number (01—12) 

%M the minute as a decimal number (00—59) 

%p the locale’s equivalent of either AM or PM 
%S the second as a decimal number (00—50) 

%U the week number of the year (Sunday is the first day of the week) as a 

decimal number (00—52) 

%x the date representation 
%X the time representation 

%y the year without century as a decimal number (00—99) 

%Y the year with century as a decimal number 

%Z the time zone name, or by no characters if no time zone exists 

For more information about the functions and types that the time. h header 
declares, refer to Section 5.1.10 on page 5-8. 
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Strlen Find string Length 


SyntQX #include <string.h> 

size__t strlen (s) 

char *s; 

Defined in strlen. c in rts. src 


Description The strlen function returns the length of s. In C, a character string is termi¬ 
nated by the first byte with a value of 0 (a null character). The returned result 
does not include the terminating null character. 
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Syntax 

Defined in 
Description 


Concatenate Strings Stmcat 


#include <string.h> 

char *strncat(sl, s2, n) 

char *sl, *s2; 
siz e_t n ; 

strncat. c in rts . src 

The strncat function appends up to n characters of s 2 (including a terminat¬ 
ing null character) to the end of si. The initial character of s2 overwrites the 
null character that originally terminated si; strncat appends a null character 
to result. The function returns the value of si. 
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Strncmp Compare Strings 


Syntax #include <string.h> 

int strncn^(sl, s2, n) 

char ^sl, *s2; 
size_t n; 

Defined in strncmp. c in rts. src 

Description The strncmp function compares up to n characters of s 2 with si. The 
function returns one of the following values: 

< Oif *si is less than *s2. 

Oif ^si is equal to ^s2. 

> 0 if *si is greater than *s2. 
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Syntax 

Defined in 
Description 


String Copy Strncpy 


#include <string.h> 

char *strncpy(sl, s2, n) 

char *sl, *s2; 
size__t n; 

strncpy. c in rts . src 

The strncpy function copies up ton characters from s 2 into si. If s2 isnchar- 
acters long or longer, the null character that terminates s2 is not copied. If 
you attempt to copy characters from overlapping strings, the function’s be¬ 
havior is undefined. If s2 is shorter than n characters, strncpy appends nuli 
characters to si so that si contains n characters. The function returns the 
value of si. 
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St rpbrk Find Any Matching Character 


Syntax 

Defined in 
Description 


5-80 


#include <string.h> 

char *strpbrk(sl, s2) 

char *sl, 

strpbrk. c in rts . src 

The strpbrk function locates the first occurrence in si of any character in s2. 
If strpbrk finds a matching character, it returns a pointer to that character; 
otherwise, it returns a null pointer ( 0 ). 


Runtime-Support Functions 



Syntax 

Defined in 
Description 


Find Last Occurrence of Character Strrch r 


#include <string.h> 

char *strrchr(s ,c) 

char *s; 
int c; 

strrchr. c in rts . src 

The strrchr function finds the last occurrence of c in s. If strrchr finds the 
character, it returns a pointer to the character; othenwise, it returns a null 
pointer ( 0 ). 
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Strspn Find Number of Matching Characters 






Syntax #include <string.h> 

size_t *strspn(sl, s2) 

int *sl, *s2; 

Defined in strspn. c in rts.src 


Description The strspn function returns the length of the initial segment of si which is 
enf/re/y made up of characters in s2. If the first character of si is notin s2, 
the strspn function returns 0 . 
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Find Matching String Strstr 


Syntax # include <string.h> 

char *strstr(sl, s2) 

char *sl, *s2; 

Defined in strstr. c in rts. src 


Description The strstr function finds the first occurrence of s2 in si (excluding the termi¬ 
nating null character). If strstr finds the matching string, it returns a pointer 
to the located string; if it doesn’t find the string, it returns a null pointer. If s 2 
points to a string with length 0, then strstr returns si. 
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Strtod/Strtol/Strtoul string to Number 


Syntax 


Defined in 


Description 


#include <stdlib.h> 

doiible strtod(nptr, endptr) 

char *nptr; 
char "^^endptr; 


long int 

char 

char 

int 


strtol(nptr, 

*nptr; 

"^^endptr; 

base; 


endptr, base) 


unsigned long int strtoul(nptr, endptr, base) 

char *nptr; 
char ^’^endptr; 
int base; 

strtod. c In rts . src 
strtol. c in rts . src 
strtoul. c in rts . src 

Three functions convert ASCII strings to numeric values. For each function, 
argument nptr points to the original string. Argument endptr points to a 
pointer; the functions set this pointer to point to the first character after the 
converted string.The functions that convert to integers also have a third ar¬ 
gument, base. 

□ The strtod function converts a string to afloating-point value. The string 
must have the following format; 

[space][sign] digits [digits][ejE[sign] integer] 

The function returns the converted string; if the original string is empty or 
does not have the correct format, the function returns a 0 . If the con¬ 
verted string would cause an overflow, the function returns 
±HUGE_VAL; if the converted string would cause an underflow, the 
function returns 0 . If the converted string causes an overflow or an un¬ 
derflow, errno is set to the value of ERANGE. 

Q The strtol function converts a string to a long integer. The string must 
have the following format: 

[space][sign] digits [digits] [ejE [sign] integer] 

□ The strtoul function converts a string to an unsigned long integer. The 
string must be specified in the following format: 

[space] [sign] digits [digits] [ejE [sign] integer] 

The space is indicated by a spacebar, horizontal or vertical tab, carriage re¬ 
turn, form feed, or newline. Following the space is an optional sign, and then 
digits that represent the integer portion of the number. The fractional part 
of the number follows, then the exponent, including an optional sign. 

The first unrecognized character terminates the string. The pointer that 
endptr points to is set to point to this character. 


5-84 


Runtime-Support Functions 








Break String into Token StrtOk 


Syntax #include <string.h> 

char *strtok(sl, s2) 

char *sl, *s2; 

Defined in strtok.c in rts.src 


Description Successive calls to the strtok function break si into a series of tokens, each 
delimited by a character from s2. Each call returns a pointer to the next 
token. 
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tan Tangent 


Syntax #include <math.h> 

double tan(x) 

double x; 

Defined in tan. ob j in rt s. lib 

Description The tan function returns the tangent of a floating-point number, x. x is an 
angle expressed in radians. An argument with a large magnitude may 
produce a result with little or no significance. 

Exampie double x, y; 

X = 3 . 1415927 / 4 . 0 ; 

y = tan(x); /* return value = 1.0 / 
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Syntax 

Defined in 
Description 

Exampie 


Hyperbolic Tangent tanh 


#include <math.h> 

doiible tanh(x) 

double x; 

tanh.obj in rts.lib 

The tanh function returns the hyperbolic tangent of a floating-point number, 

X. 

double Xf y; 

X = 0 . 0 ; 

y = tanh(x); /* return value = 0.0 */ 
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time Time 


Syntax #include <time.h> 

time (timer) 

time_t *time r; 

Defined in time. c in rts. src 

Description The time function determines the current calendar time, represented in sec¬ 
onds. If the calendar time is not available, the function returns -1. If timer 
is not a null pointer, the function also assigns the return value to the object 
that timer points to. 

For more information about the functions and types that the t ime. h header 
declares, refer to Section 5.1.10 on page 5-8. 


I-1 

Note: 

The time function is target-system specific, so you must write your own time 
function. 

I_I 


5-88 


Runtime-Support Functions 



Syntax 

Defined in 
Description 


Convert to ASCII toascH 

.V.. .v.v.-.v.-. .-.v. .*.• s-.v V.V.* v.v.v.-.-.*.*.v •. -.-.-.v.v.v.v. .-.v.. • v.w.. . 


#include <ctype.h> 

int toascii(c) 

char c; 

toascii . c in rts . src 

The toascii function ensures that c is a valid ASCII character by masking the 
lower seven bits. There is also an equivalent macro call _toascii. 
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tolower/toupper Convert Case 


Syntax #include <ctype.h> 

int tolower(c) 

char c; 

int toupper(c) 

char c; 

Definod in toiower. c in rts. scr 
toupper. c in rts . src 

Description Two functions convert the case of a single alphabetic character, c, to upper 
or lower case: 

□ The toiower function converts an uppercase argument to lowercase. 
If c is already in lowercase, toiower returns it unchanged. 

□ The toupper function converts a lowercase argument to uppercase. If 
c is already in uppercase, toupper returns it unchanged. 

The functions have macro equivalents named _tolower and _toupper. 
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Variable-Argument Macros/Function va_arg/va_end/va_Start 


Syntax tinclude <stdarg.h> 

type va_arg(ap, type) 
void va_end(ap) 
void va__start (ap, parmN) 
va_list *ap 

Description Some functions can be called with a varying number of arguments that have 
varying types. Such a function, called a variable-argument function, can use 
the following macros to step through its argument list at run time. The ap pa¬ 
rameter points to an argument in the variable-argument list. 

□ The va_start macro initializes ap to point to the first argument in an ar¬ 
gument list for the variable-argument function. The parmN parameter 
points to the rightmost parameter in the fixed, declared list. 

□ The va_arg macro returns the value of the next argument in a call to a 
variable-argument function. Each time you call va_arg, it modifies ap so 
that successive arguments for the variable-argument function can be 
returned by successive calls to va_arg (va_arg modifies ap to point to 
the next argument in the list). The type parameter is a type name; it is 
the type of the current argument in the list. 

□ The va_end macro resets the stack environment after va_start and 
va_arg are used. 

Note that you must call va_start to initialize ap before calling va_arg or 
va_end. 

Exampie Int printf(fmt) /* Has 1 fixed argument and */ 

char ’^fmt /* additional variable arguments '^/ 

{ 

va_list ap; 
va_start(ap, fmt); 


/* Get next arg, an integer 
i = va_arg(ap, int); 

/* Get next arg, a string 

s = va_arg(ap, char *) ; 
/* Get next arg, a long 

1 = va_arg(ap, long); 


va_end{ap) Reset 

} 
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Appendix A 


ErrorMessages 


Compiler error messages are displayed in the following format, which 
shows the line nu mber in which the error occurs and the text of the message: 

“name.c”, line n: error message 

These types of errors are not fatal. 

Fatal Error messages 

The errors listed below cause the compiler to abort immediately. 

□ » cannot allocate sufficient memory 

The compiler requires a minimum of 512K bytes of memory to run; this 
message indicates that this amount is not available. Supply more dy¬ 
namic RAM. 

□ » can’t open “filename” as source 

The compiler cannot find the file name as entered. Check for spelling 
errors and check to see that the named file actually exists. 

□ » can’t open “filename” as intermediate file 

The compiler cannot create the output file. This is usually caused by 
either an error in the syntax of the filename or a full disk. 

□ » illegal extension “ext” on output file 

The intermediate file cannot have a “.c” extension. 

□ »fatal errors found: no intermediate file produced 

This message is printed after an unsuccessful compilation. Correct the 
errors (other messages will indicate particular errors) and try compila¬ 
tion again. 

□i » cannot recover from earlier errors: aborting 

An error has occurred that prevents the compiler from continuing. 
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Appendix B 


Preprocessor Directives 


The C preprocessor provided with this package is standard and follows Ker- 
nighan and Ritchie exactly. This appendix summarizes the directives that 
the preprocessor supports. Generally, the directives are organized alpha¬ 
betically, one directive per page; however, related directives (such as 
#if/#else) are presented together on one page. Here’s an alphabetical table 
of contents for the preprocessor directives reference: 


Directive Page 

#define . B-2 

#else. B-3 

#endif. B-3 

#if . B-3 

#ifdef .B-3 

fifndef . B-3 

#include .B-5 

#line.B-6 

#undef . B-2 
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#define/#undef Define/Undefine Macros Directives 

Syntax #define name[(arg,...,arg)] token-string 

#undef name 

Description The preprocessor supports two directives for defining and undefining 

macros and constants; 

□ The #define directive assigns a string to a macro. Subsequent 
occurrences of name are replaced by token-string. The name can be 
immediately followed by an argument list; the arguments are separated 
by commas, and the list is enclosed in parentheses. Each occurrence 
of an argument is replaced by the corresponding set of tokens from the 
comma-separated string. 

When a macro with arguments is expanded, the arguments are placed 
into the expanded to/cen-sfr/ng unchanged. After the entire token-string 
is expanded, the preprocessor scans again for names to expand at the 
beginning of the newly created token-string, which allows for nested 
macros. 

Note that there is no space between name and the open parenthesis at 
the beginning of the argument list. A trailing semicolon is not required; if 
used, it is treated as part of the token-string. 

□ The #undef directive undefines the macro name; that is, it causes the 
preprocessor to forget the definition of name. 

Example The following example defines the constant f: 

idefine f(a,b,c) 3*a+b-c 

The following line of code uses the definition of f: 

f(27,begin,minus) 

This line is expanded to: 

3'^27+begin-minus 

To undefine f, enter: 

#undef f 
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Conditional Processing Directives #if/#ifdef/#ifndef/#else/#endif 


Syntax #if constant-expression 

code to compile if condition is true 

[#else 

code to compile if condition is false] 

#endif 

#ifdef name 

code to compile if name is defined 

[#else 

code to compile if name is not defined] 

#endif 

#ifndef name 

code to compile if name is not defined 

[#else 

code to compile if name is defined] 

#endif 

Description The C preprocessor supports five conditional processing directives: 

□ Three directives can begin a conditional block: 

B The #if directive tests an expression. The code following an #if 
directive (up to an #else or an #endif) is compiled if the constant-ex¬ 
pression evaiuates to a nonzero value. All binary non-assignment C 
operators, the ?: operator, the unary- I, and % operators are legal 
in constant-expression. The precedence of the operators is the 
same as in the definition of the C language. The preprocessor also 
supports a unary operator named defined, which can be used in 
constant-expression in one of two forms: 

1) defined(name) Of 

2) defined name 

This allows the the utility of #ifdef and #ifndef in an #if directive. Only 
these operators, integer constants, and names which are known by 
the preprocessor should be used in constant-expression. In 
particular, the s/zeof operator should not be used. 

■ The #ifdef directive tests to see if name is a defined constant. The 
code following an #ifdef directive (up to an #else or an #endif) is 
compiled if name is defined (by the #define directive) and it has not 
been undefined by the #undef directive. 
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#if/#ifdef/#ifndef/#eise/#endif Conditional Processing Directives 


■ The #lfndef directive tests to see if name is nof a defined constant. 
The code following an #ifndef directive (up to an #else or an #endif) 
is compiled if name is not defined (by the #define directive) or if it 
was undefined by the #undef directive. 

□ The #else directive begins an alternate block of code that is compiled 
if: 

■ The condition tested by #if is false. 

8S The name tested by #ifdef is not defined. 

® The name tested by #ifndef is defined. 

Note that the #else portion of a conditional block is optional-, if the #if, 
#ifdef, or #ifndef test is not successful, then the preprocessor continues 
with the code following the #endif. 

□ The #endif directive ends a conditional block. Each #if, #ifdef, and 
#ifndef directive must have a matching #endif. Conditional compilation 
sequences can be nested. 
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Include Code from Another File Directive #include 


Syntax #include "filename” 
or 

#include <filename> 

Description The #include directive tells the preprocessor to read source statements 
from another file. The preprocessor includes (at the point in the code where 
#include is encountered) the contents of the filename, which are then pro¬ 
cessed. You can enclose the filename in double quotes or in angle brackets. 

The filename can be a complete pathname or a filename with no path infor¬ 
mation. 

□ If you provide path information for filename, the preprocessor uses that 
path and does not look for the file in any other directories. 

□ If you do not provide path information and you enclose the filename in 
double quotes, the preprocessor searches for the file in: 

1) The directory that contains the current source file. (The current 
source file refers to the file that is being processed when the prepro¬ 
cessor encounters the #include directive.) 

2) Any directories named with the -i preprocessor option. 

3) Any directories named with the C_DIR environment variable. 

□ If you do not provide path information and you enclose the filename in 
angle brackets, the preprocessor searches for the file in: 

1) Any directories named with the -i preprocessor option. 

2) Any directories named with the C_DIR environment variable. 


I-1 

Note: 

If you enclose the filename in angle brackets, the preprocessor does not 
search for the file in the current directory. 


L 




#line Line Control Directive 


■ V.V.V.V.;.-. .;.-.v.v.y.v.-.-.v.v.v v.v.v.v.v.v.v.v.;.-.-.-. .-.v.v.v 


Syntax #line integer-constant [’’filename”] 

Description The #line directive generates line control information for the next pass of the 
compiler. The integer-constant \s the line number of the next line, and the 
filename is the file where that line exists. If you do not provide a filename, 
the current filename (specified by the last #line directive) is unchanged. 

This directive effectively sets the_ line _and_ ^file _symbols. 
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Appendix C 


Increasing Code 
Generation Efficiency 


The efficiency of the code generated by the TMS320C30 C compiler 
depends largely on how effectively you take advantage of the C compiler op¬ 
timizations. The following list describes the key constructs that can vastly 
improve the compiler’s effectiveness. 

□ Use register variables for often-used variables. This is particularly im¬ 
portant for pointer variables (the compiler allocates four registers for 
pointer register variables). For example, the following code fragment 
exchanges one memory object with another; 

do 

{ 

temp = *++src; 

*src == *++dest; 

*dest = temp; 

} 

while (—n) 

Without register variables, this code takes 12 instructions and 19/? 
cycles. With register variables, this code takes only 4 instructions and 
7n cycles. 

□ Avoid integer multiplies (or use the -m option). The TMS320C30 
MPYI instruction uses 24-bit operands, forcing the compiler to use run¬ 
time support to do full 32-bit arithmetic. You can use the -m option, 
which forces the compilerto use MPYI, if you know 24-bit multiplies are 
sufficient for your application. 

□ Pre-compute subexpressions, especially array references in loops. 
Assign commonly used expressions to register variables where pos¬ 
sible. 

□ Use *++ to step through arrays, rather than using an index to recalcu¬ 
late the address each time through a loop. 
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As an example of pre-computing subexpressions and using *++ to step 
through arrays, consider the following loops: 


main () 

{ 

float a[10], b[10]; 
int i; 

for (i = 0; i < 10/ ++i) 
a[i] = (a[i] ^ 20) + b[i] ; 


Executes in 19 Cycles 


main () 

{ 

float a[10], b[10]; 
int i; 

register float == a, ’^q = b; 

for (i = 0/ i < 10/ ++i) 
^p++ = (*p * 20) + ’*fq++/ 

} 

Executes in 12 Cycles 


□ Use structure assignments to copy blocks of data. The compiler 
generates very efficient code forstructure assignments; therefore, nest 
objects within structures and use simple assignments to copy them. 

Q Avoid large local frames, and declare the most often used local 
variables first. The compiler uses indirect addressing with an 8-bit off¬ 
set to access local data. To access objects on the local frame that have 
offsets greater than 255, the compiler must first load the offset into an 
index register resulting int extra instruction and 2 cycles of pipeline 
delay. 

□i Avoid the big memory model. The big model is inefficient because the 
compiler reloads the data page pointer (DP) before each access to a 
global or static variable. If you have large array objects, use maiioc {) 
to dynamically allocate and access the variables via pointers rather than 
declaring them globally. For example: 


int a [100000]; int *a =(int *)malloc (100000); / 

a[i] = 10; /* 11 cycles */ a[i] = 10; /* 5 cycles */ 

Inefficient for Large Array Objects Efficient for Large Array Objects 
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a.out, 2-24 

abort function, 5-18 

abs function, 5-19 

absolute value, 5-19, 5-39 

accessing arguments in a function, 4-16 

accessing local variables In a function, 4-16 

acos function, 5-20 

aliased variables, 2-22 

alignment, 3-6, 4-8 

alternate directories for include files, 2-18 

ANSIC, 1-5, 3-1,5-71,5-74 

AR3 register. See FP register 

arc cosine, 5-20 

arc sine, 5-22 

arc tangent, 5-24 

archive library, 2-24 

archiver, 1-3, 2-28 

arguments, 4-15, 4-16 

array, 3-5 

ASCII conversion functions, 5-27 
asctime function, 5-21,5-34 
asin function, 5-22 
asm statement, 3-11,4-22, 4-23 
assembler, 1-3 
options 
-a/, 2-9 
-ax, 2-9 


assembly language, 4-18 
assembly language interrupt routines, 4-24 
assert function, 5-23 
assert.h header, 5-2, 5-10 
atan function, 5-24 
atan2 function, 5-25 
atexit function, 5-26, 5-37 
atof function, 5-27 
atoi function, 5-27 
atol function, 5-27 
autoincrement addressing, 4-29 
autoinitialization, 2-25 
of constants, 4-30 
of variables, 4-30 
RAM model, 2-26, 4-32 
ROM model, 2-27, 4-33 



base-10 logarithm, 5-50 

big memory model, 1-4, 2-22, 4-3, 4-10, C-2 

bit fields, 4-8 

block-repeat registers, 4-14 
boot routine, 4-30 
boot.asm, 4-5 
boot.obj, 2-24—2-25, 2-27 
broken-down time, 5-8, 5-34 
broken-down time function, 5-59 
bsearch function, 5-28 
.bss section, 4-2—4-7, 4-20 
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C compiler, 1-3,1-4 

C interrupt routines, 4-23 

C language. See TMS320C30 C Language 

-c linker option, 2-11,2-24, 2-27, 4-30 See 
linker options 

~c option, (CL30), 2-12 
ctype.h header, 5-10 

C_DIR environment variable, 2-18, 2-19, B-5 
_cjnt00, 2-25, 2-27, 4-23, 4-30 
C_OPTION environment variable, 2-13 
calendar time, 5-8, 5-34, 5-35, 5-59, 5-88 

calling conventions. See function calling con¬ 
ventions 

calloc function, 4-6, 5-29, 5-42, 5-58 

cc30, 2-21 

ceil function, 5-30 

cg30, 2-22 

character string constants, 4-9 

character typing conversion functions, 5-3, 
5-10 

isalnum, 5-45 
isalpha, 5-45 
isascii, 5-45 
iscntrl, 5-45 
isdigit, 5-45 
isgraph, 5-45 
islower, 5-45 
isprint, 5-45 
ispunct, 5-45 
isspace, 5-45 
isupper, 5-45 
isxdigit, 5-45 
toascii, 5-89 
tolower, 5-90 
toupper, 5-90 

.cinit section, 2-27, 4-2, 4-4, 4-7, 4-19,4-31, 
4-32 

CL30, 1-3,1-5, 1-6, 2-3 
options 
-c,2-12 


-s,2-14 
-z,2-11 
overview, 2-2 
d30, 2-3 
clist, 2-15 

CLK_TCK macro, 5-8, 5-31 
clock function, 5-31 
clockj type, 5-8 

code generator, 2-16, 2-22—-2-28 
options 
-a, 2-22 
-b, 2-22 
-m, 2-22 
-o, 2-23 
-q, 2-23 
-V, 2-23 
-X, 2-23 
-z, 2-23 
-n, 2-23 

COFF, 1-3,1-4, 4-2 
compare strings, 5-78 
compiler 

operation, 2-1—2-28 
overview, 2-2 

concatenate strings, 5-69, 5-77 
conditional compilation, 2-17 
conditional processing, B-3 
CONST symbol, 4-10 
constant table, 4-8, 4-10 
constants 

character, 3-2 
enumeration, 3-2 
Integer, 3-2 
string, 3-3 
conversion, 5-3 
cos function, 5-32 
cosh function, 5-33 
cosine, 5-32 
cpp30, 2-17 

-cr linker option, 2-24, 2-26, 4-30 See linker 
options 

ctime function, 5-34 
ctype.h header, 5-3 
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D 


data page pointer register, 4-3 
data pointer (DP), 4-3, 4-14, 4-30, C-2 
.data section, 4-3 
data size, 1-4 
data type storage, 4-8 
data types, 3-5, 4-8 
added, 3-4 
data sizes, 3-4 
derived, 3-4 
equivalent, 3-4 
name, 3-4 

_DATE_2-18 

daylight savings time, 5-8 
declarations, 3-7 
dedicated registers, 4-18 
#define preprocessor directive, B-2 
delayed branches, 4-29 
derived types, 3-4, 3-5 
diagnostic information, 5-23 
diagnostic messages, 5-2 
assert, 5-23 

NDEBUG macro. See NDEBUG macro 
difftime function, 5-35 
div function, 5-36 
DIV_F function, 4-26, 4-27 
DIVJ function, 4-26, 4-27 
div_t type, 5-7 
DIV_U function, 4-27 
division, 4-26 
DIVU instruction, 4-26 
DP register, 4-14 
dynamic memory allocation, 4-6 



EDOM macro, 5-6 

#else preprocessor directive, B-3—-B-4 
emulator, 1 -3 

#endif preprocessor directive, B-3—B-4 


entry points 
cJntOO, 2-25 
for C code, 2-25 
reset vector, 2-25 
enum, 3-4, 3-7 

enumeration declarations, 3-7, 3-8 
environment variable. See C_OPTION 
environment variable (preprocessor), 2-19 
EPROM programmers, 1-3 
ERANGE macro, 5-6 
errno.h header, 5-6 
error message macros, 5-10 
assert, 5-23 

error messages, 2-18, 2-21, A-1 
error reporting, 5-6 
exit, 5-26 

exit function, 5-18, 5-37 
exp function, 5-38 
exponential function, 5-38 
exponential math function, 5-5 
expression analysis, 4-25 
expressions, 3-6 
external definitions, 3-7 
external variables, 3-10 


F 


fabs function, 5-39 
fatal errors messages, A-1 

_FILE_, 2-18 

filename specifications, 2-4 
float.h header, 5-3 

floating-point math functions, 5-5, 5-11 
acos, 5-20 
asin, 5-22 
atan, 5-24 
atan2, 5-25 
ceil, 5-30 
cos, 5-32 
cosh, 5-33 
exp, 5-38 
fabs, 5-39 
floor, 5-40 
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fmod, 5-41 
frexp, 5-43 
Idexp, 5-47 
log, 5-49 
logic, 5-50 
modf, 5-60 
pow, 5-62 
sin, 5-66 
sinh, 5-67 
sqrt, 5-68 
tan, 5-86 
tanh, 5-87 

floating-point register variables, 4-13 
floating-point remainder, 5-41 
floor function, 5-40 
fmod function, 5-41 
FP register, 4-5, 4-14,4-16 
frame pointer, 4-16 
free function, 5-42 
frexp function, 5-43 
function calling conventions 

accessing arguments and local variables, 
4-16 

called function responsibilities, 4-16 
calling function responsibilities, 4-15 
returning structures, 4-17 
saving/restoring registers, 4-16 
stack use, 4-15—4-17 

function structure conventions. See function 
calling conventions 


G 


-g option, 4-29 

general utility functions, 5-7,5-12 
abort, 5-18 
abs, 5-19 
atexit, 5-26 
atof, 5-27 
atoi, 5-27 
atol, 5-27 
bsearch, 5-28 
calloc, 5-29 
div, 5-36 
exit, 5-37 


free, 5-42 
labs, 5-19 
Idiv, 5-36 
Itoa, 5-51 
malloc, 5-52 
minit, 5-58 
movmem, 5-61 
qsort, 5-63 
rand, 5-64 
realloc, 5-65 
srand, 5-64 
strtod, 5-84 
strtol, 5-84 
strtoul, 5-84 

global variables, 3-10, 4-3,4-30,4-31 
addressing, 4-8 
reserved space, 4-2 
gmtime function, 5-44 
gregorian time, 5-8 


H 


hardware requlrements~PC systems, 1-8 
header files, 5-2—5-8 
assert.h header, 5-2 
ctype.h header, 5-3 
errno.h header, 5-6 
float, h header, 5-3 
limits.h header, 5-3 
math.h header, 5-5 
stdarg.h header, 5-6 
stddef.h header, 5-6 
stdiib.h header, 5-7 
string.h header, 5-7 
time.h header, 5-8 
heap, 4-6, 5-52 
HUGE^VAL, 5-5 
hyperbolic cosine, 5-33 
hyperbolic math function, 5-5 
hyperbolic sine, 5-67 
hyperbolic tangent, 5-87 



-i preprocessor option, 2-18, 2-19, B-5 
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identifiers, 3-2, 4-19 
#if preprocessor directive, B-3 
#ifdef preprocessor directive, B-3 
#include files, 2-17 
include files, 2-18 

#lnclude preprocessor directive, 5-2 
index registers, 4-14, 4-26 
initialization, 4-30 
initialization tables, 4-31 
format, 4-31 
initialized sections, 4-2 
inline assembly construct (asm), 3-11 
installation 

Macintosh, 1-10 
PCs, 1-8 
VAX/Ultrix, 1-9 
VAXA/MS, 1-9 
workstations with UNIX, 1-9 
integer division, 5-36 
integer multiplies, C-1 
integer register variables, 4-13 
interfacing C with assembly language, 4-18 
asm statement, 4-22 
assembly language modules, 4-18 
defining variables, 4-20 
inline assembly language, 4-22 
modifying compiler output, 4-22 
interlist utility, 1-3,1-5,1-7, 2-1,2-14, 2-15 
intermediate file, 2-21 
interrupt handling, 4-23 

assembly language interrupt routines, 
4-24 

interrupt routines, 4-23 
saving registers, 4-23 
interrupt routines, 4-18,4-23 
inverse tangent of y/x, 5-25 
Invoking the 
C compiler, 2-3 
CL30 program, 2-3 
code generator, 2-22 
interlist utility, 2-14 
linker, 2-11,2-18 
parser, 2-21 


preprocessor, 2-17 
Isalnum function, 5-45 
Isalpha function, 5-45 
isascii function, 5-45 
iscntrl function, 5-45 
isdigit function, 5-45 
isgraph function, 5-45 
islower function, 5-45 
isprint function, 5-45 
Ispunct function, 5-45 
isspace function, 5-45 
isupper function, 5-45 
isxdigit function, 5-45 
isxxx function, 5-3, 5-45 


K 


Kernighan and Ritchie, 1-4, 2-18, 3-1 
preprocessor, 2-17 

The C Programming Language, Iv, 1-1 
keywords, 3-2 

Kochan, S., Programming in C, Iv 



labs function, 5-19 
Idexp function, 5-47 
Idiv function, 5-36 
ldiv__t type, 5-7 
lexical scope rules, 3-10 
limits 

floating-point types, 5-3 
integer types, 5-3 
limits.h header, 5-3 
line number directives, 2-17 

_LINE_, 2-18 

linker, 1-3, 2-11—2-12,2-28,4-2 
options, 2-10 
-c, 2-12, 2-27 
-cr, 2-12, 2-27 
linker command file, 2-25 
linking, 4-4 
linking C code, 2-24 
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Ink30, 2-24, 2-26 

loader, 4-11,4-32 

local frame, 4-16 

local variables, 4-16 

localtime, 5-8, 5-34 

localtime function, 5-48, 5-59 

log function, 5-49 

loglO function, 5-50 

long immediate values, 4-8 

loop rotation, 4-29 

Itoa function, 5-51 



Macintosh installation, 1-10 
macro, B-2 

macro definitions, 2-17 
main function, 4-30 

malloc function, 4-6, 5-42, 5-52, 5-58, C-2 
map file, 2-25 
math routines, 4-26—4-27 
math.h header, 5-5, 5-11 
member names, 3-8 
memchr function, 5-53 
memcmp function, 5-54 
memcpy function, 5-55 
memmove function, 5-56 
MEMORY linker directive, 2-24 
memory management functions 
calloc, 5-29 
free, 5-42 
malloc, 5-52 
minit, 5-58 
movmem, 5-61 
realloc, 5-65 
memory model, 4-2 
big memory model, 4-3 
dynamic memory allocation, 4-6 
RAM model, 4-7 
ROM model, 4-7 
sections, 4-2 
small memory model, 4-3 


stack, 4-5 
memory pool, 5-52 
memset function, 5-57 
minit function, 5-58 
mktime function, 5-59 
-mn option, 4-29 
MODJ function, 4-26, 4-27 
MOD__U function, 4-27 
modf function, 5-60 
MODU Instruction, 4-26 
movmem function, 5-61 
MPYJ function, 4-27 
MPYI instruction, 4-26 
multiplication, 4-26 



natural logarithm, 5-49 
NDEBUG macro, 5-2, 5-23 
normal optimization, 2-23 
NULL macro, 5-6 



object alignment, 3-6 
object format converter, 1 -3 
object libraries, 2-24,2-26 
object representation, 4-8 

addressing global variables, 4-8 
character string constants, 4-9 
constant table, 4-10 
data type storage, 4-8 
long immediate values, 4-8 
offsetof macro, 5-6 
optimization, 1-4, 4-28 
options, 2-6—2-10 
conventions, 2-6 
general 

-f, 2-8 

-/of/r, 2-7 
-k, 2-7 
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-n, 2-8 

-qq, 2-8 
-s, 2-8 
-z, 2-8, 2-11 



parallel instructions, 4-29 
parser, 2-16, 2-21 
PC installation, 1-8 
pointer register variables, 4-13 
pointers, 3-4 

data size, 3-4—3-6 
pow function, 5-62 
power, 5-62 

predefined macro names, 2-18 
preinitialized variables, 4-30 
preprocessor, 2-16, 2-17 
environment variable, 2-19 
options 
-c,2-17 

-dname[=def], 2-17 

-P,2-17 

-pc, 2-9 

-PA 2-9 

-q,2-17 

-i, 2-19, B-5 

idir, 2-17 

predefined macro names, 2-18 
preprocessor directives, 2-18, B-1 
#ifndef, B-3—B-4 
#define, B-2 
#else, B-3—B-4 
#endif, B-3—B-4 
#if, B-3 
#ifdef, B-3 
#include, B-5 
#undef, B-2 

program termination functions 
abort (exit), 5-18 
atexit, 5-26 
exit, 5-37 

progress information, 2-5 


progress messages, 2-21 
pseudo-random, 5-64 
ptrdiff_t type, 5-6 


Q 


-q option, 2-5, 2-21 
qsort function, 5-63 


R 


RAM model of initialization, 2-26, 4-31,4-32 
rand function, 5-64 
RAND_MAX macro, 5-7 
realloc function, 4-6, 5-42, 5-58, 5-65 
register conventions, 4-12 
AR3 (FP) register, 4-14 
block-repeat registers, 4-14 
DP register, 4-14 

expression analysis registers, 4-12 
FP (AR3) register, 4-14 
list of registers, 4-12 
register variables, 4-13 
return values, 4-13 
SP register, 4-14 
register tracking, 4-28 
register variables, 3-7, 3-11,4-13, 4-28, C-1 
registers, 4-23, 4-25, 4-26 
related documentation 

Advanced C: Techniques and Applica¬ 
tions, iv 

Programming in C, Iv 
The C Programming Language, iv 
responsibilities of a called function, 4-16 
responsibilities of a calling function, 4-15 
ROM model of initialization, 2-25, 2-27, 4-31, 
4-33 

rts.lib, 2-24—2-25, 2-27, 4-4,4-26, 4-30, 5-1 
rts.src, 4-5, 4-26, 5-1,5-7 
runtime environment, 4-1—4-34 

calling conventions. See function calling 
conventions 

expression analysis, 4-25 
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function structure. See function calling 
conventions 

interfacing C with assembly language, 
4-18 

assembly language modules, 4-18 
defining variables, 4-20 
inline assembly language, 4-22 
modifying compiler output, 4-22 
interrupt handling, 4-23 

assembly language interrupt routines, 
4-24 

interrupt routines, 4-23 
saving registers, 4-23 
math routines, 4-26—4-27 
memory model, 4-2 
big memory model, 4-3 
dynamic memory allocation, 4-6 
RAM model, 4-7 
ROM model, 4-7 
sections, 4-2 
small memory model, 4-3 
stack, 4-5 

object representation, 4-8 

addressing global variables, 4-8 
character string constants, 4-9 
constant table, 4-10 
data type storage, 4-8 
long immediate values, 4-8 
register conventions, 4-12 

expression analysis registers, 4-12 
list of registers, 4-12 
register variables, 4-13 
return values, 4-13 
system initialization, 4-30—4-34 

autoinitializing variables and constants, 
4-30 

initialization table format, 4-31 
RAM model, 4-32 
ROM model, 4-33 

runtime initialization, 2-24 

runtime model, options 
-ma, 2-9 
-mb, 2-9 
-mm, 2-9 
-mr, 2-9 
-mv, 2-9 


-mx, 2-9 

runtime support, 2-24 
math routines, 4-26 
runtime support functions, 5-1—5-17 
descriptions, 5-16—5-17 
summary table, 5-9—5-17 
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-s CL30 option, 2-14 
saving registers during interrupts, 4-23 
saving/restoring registers, 4-16 
searches, 5-28 
section 
.cinit, 4-2 
.stack, 4-2 
.text, 4-2 
.bss, 4-2 
.data, 4-3 
.sysmem, 4-3 
sections, .stack, 4-30 
SECTIONS linker directive, 2-24 
short multiply, 2-22 
silicon bugs, 2-23 
simulator, 1-3 
sin function, 5-66 
sine, 5-66 
sinh function, 5-67 
size__t type, 5-6 
sizeof, 3-6 
SLn,4-9 

small memory model, 1-4,4-3,4-10, 4-30 
Sobelman and Krekelberg, Advanced C: 

Techniques and Applications, iv 
software development tools, 1-2—1-3 
sorts, 5-63 

SP register, 4-5, 4-14 

SPOX, 1-5 

sqrt function, 5-68 

square root, 5-68 

srand function, 5-64 

stack overflow, 4-6 

.stack section, 4-2, 4-5—4-6, 4-30 
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STACK_SIZE, 4-5—4-6 
static variables, 3-10, 4-30, 4-31 
addressing, 4-8 
reserved space, 4-2 
stdarg.h header, 5-6, 5-12 
stddef.h header, 5-6 
stdiib.h header, 5-7, 5-12 
strcat function, 5-69 
strchr function, 5-70 
strcmp function, 5-71 
strcoll function, 5-71 
strcpy function, 5-72 
strcspn function, 5-73 
strerror function, 5-74 
strftime function, 5-75 
string copy, 5-79 
string functions, 5-7, 5-14 
memchr, 5-53 
memcmp, 5-54 
memcpy, 5-55 
memmove, 5-56 
memset, 5-57 
strcat, 5-69 
strchr, 5-70 
strcmp, 5-71 
strcoll, 5-71 
strcpy, 5-72 
strcspn, 5-73 
strerror, 5-74 
strlen, 5-76 
strncat, 5-77 
strncmp, 5-78 
strncpy, 5-79 
strpbrk, 5-80 
strrchr, 5-81 
strspn, 5-82 
strstr, 5-83 
strtok, 5-85 
string label, 4-9 
string.h header, 5-7, 5-14 
strlen function, 5-76 
strncat function, 5-77 
strncmp function, 5-78 


strncpy function, 5-79 
strpbrk function, 5-80 
strrchr function, 5-81 
strspn function, 5-82 
strstr function, 5-83 
strtod function, 5-84 
strtok function, 5-85 
strtol function, 5-84 
strtoul function, 5-84 

structure conventions. See function calling 
conventions 

structures, 3-7, 3-8, 4-17 
STYP_COPY, 4-32 
STYP_CPYflag, 2-27 
symbol and style conventions, v 
symbolic debugging, 2-15, 4-29 
symbolic debugging directives, 2-23 
.sysmem, 4-4 
.sysmem section, 4-3, 4-6 
sysmem.asm, 4-6 

_SYSMEM_SiZE, 4-5^-6, 5-7 

system constants 
CONST, 4-10 

_SYSMEM_SIZE, 4-5 

system initialization, 4-30—4-34 

autoinitializing variables and constants, 
4-30 

boot routine, 4-30 
initialization table format, 4-31 
RAM model, 4-32 
ROM model, 4-33 
system reset, 4-24 
system stack, 4-5 



_320C30, 2-18 
3-operand instructions, 4-28 
tan function, 5-86 
tangent, 5-86 
tanh function, 5-87 
.text section, 4-2, 4-4 
time, 5-21 
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time function, 5--88 

time functions, 5-8, 5-15 
asctime, 5-21 
clock, 5-31 
ctime, 5-34 
difftime, 5-35 
gmtime, 5-44 
localtime, 5-48 
mktime, 5-59 
strftime, 5-75 
time, 5-88 

time.h header, 5-8, 5-15 

_^TIME_, 2-18 

time_t type, 5-8 

tm structure, 5-8 

tm type. See broken-down time 

TMS320C30 C language, 3-1—3-12 
See also ANSI C language 
asm statement, 3-11 
constants, 3-2 
data types, 3-4—3-5 
declarations, 3-7—3-9 
enum. See enum 
expressions, 3-6 
external definitions, 3-7 
global variables, 3-10 
identifiers, 3-2 
keywords, 3-2 
lexical scope rules, 3-10 
object alignment, 3-6 
related documentation 

Advanced C: Techniques and Applica¬ 
tions, iv, 3-1 
Programming in C, iv 
The C Programming Language, iv 
static variables, 3-10 
TMS320C30 target system, 1-3 
toascii function, 5-89 


tokens, 5-85 
tolower function, 5-90 
toupper function, 5-90 
trigonometric math function, 5-5 
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#undef preprocessor directive, B-2 
uninitialized sections, 4-2 
union, 3-8 

UNIX workstation installation, 1-9 
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va_arg function, 5-91 
va_end function, 5-91 
va_start function, 5-91 
variable argument functions and macros, 
5-6, 5-12 
va_arg, 5-91 
va_end, 5-91 
va_start, 5-91 

variable-argument function, 5-91 
variable-argument functions and macros, di¬ 
rectives. See preprocessor directives 
VAX/Ultrix installation, 1-9 
VAXA/MS installation, 1-9 
void, 3-4, 3-6 
volatile variables, 2-23 



wildcard, 2-4 
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XDS emulator, 1-3 
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Orlando: Arrow/Klerulff (407) 323-0252; 

Hall-Mark (407) 830-5855; Marshall (407) 767-8585; 
Schweber (407) 331-7555; Zeus (407) 365-3000; 
Tampa: Hall-Mark (813) 530-4543; 

Marshall (813) 576-1399; Schweber (813) 541-5100. 


NEW YORK: Long Island: 

Arrow/Klerulff (516) 231-1009; Hall-Mark (516) 737-0600; 
Marshall (516) 273-2424; Schweber (516) 334-7474; 
Zeus (914) 937-7400; 

Rochester: Arrow/Klerulff (716) 427-0300; 

Hall-Mark (716) 425-3300; Marshall (716) 235-7620; 
Schweber (716) 424-2222; 

Syracuse: Marshall (607) 798-1611. 


NORTH CAROLINA: Arrow/Klerulff (919) 876-3132, 
(919) 725-8711; Hall-Mark (919) 872-0712; 

Marshall (919) 878-9882; Schweber (919) 876-0000. 


OHIO: Cleveland: Arrow/Klerulff (216) 248-3990; 
Hall-Mark (216) 349-4632; Marshall (216) 248-1788; 
Schweber (216) 464-2970; 

Columbus: Hall-Mark (614) 888-3313; 

Dayton: Arrow/Klerulff (513) 435-5563; 

Marshall (513) 898-4480; Schweber (513) 439-1800. 


OKLAHOMA: Arrow/Klerulff (918) 252-7537; 
Schweber (918) 622-8003. 


OREGON: Arrow/Klerulff (503) 645-6456; 
Marshall (503) 644-5050; Wyle (503) 640-6000. 


PENNSYLVANIA: Arrow/Klerulff (412) 856-7000, 
(215) 928-1800; GRS Electronics (215) 922-7037; 
Marshall (412) 963-0441; Schweber (215) 441-0600, 
(412) 963-6804. 


TEXAS: Austin: Arrow/Klerulff (512) 835-4180; 
Hall-Mark (512) 258-8848; Marshall (512) 837-1991; 
Schweber (512) 339-0088; Wyle (512) 834-9957; 
Dallas: Arrow/Klerulff (214) 380-6464; 

Hall-Mark (214) 553-4300; Marshall (214) 233-5200; 
Schweber (214) 661-5010; Wyle (214) 235-9953; 
Zeus (214) 783-7010; 

El Paso: Marshall (915) 593-0706; 

Houston: Arrow/Klerulff (713) 530-4700; 

Hall-Mark (713) 781-6100; Marshall (713) 895-9200; 
Schweber (713) 784-3600; Wyle (713) 879-9953. 


UTAH: Arrow/Klerulff (801) 973-6913; 

Hall-Mark (801) 972-1008; Marshall (801) 485-1551; 
Wyle (801) 974-9953. 


GEORGIA: Arrow/Klerulff (404) 449-8252; 

Hall-Mark (404) 447-8000; Marshall (404) 923-5750; 
Schweber (404) 449-9170. 

ILLINOIS: Arrow/Klerulff (312) 250-0500; 

Hall-Mark (312) 860-3800; Marshall (312) 490-0155; 
Newark (312) 784-5100; Schweber (312) 364-3750. 

INDIANA: Indianapolis: Arrow/Klerulff (317) 243-9353; 
Hall-Mark (317) 872-8875; Marshall (317) 297-0483; 
Schweber (317) 843-1050. 

IOWA: Arrow/Klerulff (319) 395-7230; 

Schweber (319) 373-1417. 

KANSAS: Kansas City: Arrow/Klerulff (913) 541-9542; 
Hall-Mark (913) 888-4747; Marshall (913) 492-3121; 
Schweber (913) 492-2922. 


WASHINGTON: Arrow/Klerulff (206) 575-4420; 
Marshall (206) 486-5747; Wyle (206) 881-1150. 

WISCONSIN: Arrow/Klerulff (414) 792-0150; 
Hall-Mark (414) 797-7844; Marshall (414) 797-8400; 
Schweber (414) 784-9020. 

CANADA: Calgary: Future (403) 235-5325; 
Edmonton: Future (403) 438-2858; 

Montreal: Arrow Canada (514) 735-5511; 

Future (514) 694-7710; 

Ottawa: Arrow Canada (613) 226-6903; 

Future (613) 820-8313; 

Quebec City: Arrow Canada (418) 871-7500; 
Toronto: Arrow Canada (416) 672-7769; 

Future (416) 638-4771; Marshall (416) 674-2161; 
Vancouver: Arrow Canada (604) 291-2986; 

Future (604) 294-1166. 


Texas 

Instruments 


Customer 
Response Center 

TOLL FREE: (800) 232-3200 

OUTSIDE USA: (214)995-6611 

(8:00 a.m. - 5:00 p.m. CST) 
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